spring-cloud-contract icon indicating copy to clipboard operation
spring-cloud-contract copied to clipboard

Docs: single html/pdf for 3.1.0 is broken

Open gavvvr opened this issue 3 years ago • 3 comments

For 3.1.0 you will see some ascciidoc-related stuff and no docs.:

https://docs.spring.io/spring-cloud-contract/docs/3.1.0/reference/htmlsingle/ https://docs.spring.io/spring-cloud-contract/docs/3.1.0/reference/pdf/index.pdf

For comparison 3.0.0 full html works just fine: https://docs.spring.io/spring-cloud-contract/docs/3.0.0/reference/htmlsingle/

gavvvr avatar Feb 16 '22 15:02 gavvvr

It seems that all of our single page docs are broken for all the cloud projects :grimacing:

marcingrzejszczak avatar Feb 16 '22 20:02 marcingrzejszczak

It seems the correct single page docs are published under <projectname>.html instead of index.html: https://docs.spring.io/spring-cloud-contract/docs/3.1.0/reference/htmlsingle/spring-cloud-contract.html

jonatan-ivanov avatar Feb 16 '22 20:02 jonatan-ivanov

Thanks for the link @jonatan-ivanov ! The source code snippet is also broken in 8.6.3 section of 3.1.0 docs and at least 8.7.4 Looks good in 3.0.0

gavvvr avatar Feb 18 '22 15:02 gavvvr

I've built the documentation locally and it works well with all the versions. Let's see if the next release is better.

marcingrzejszczak avatar Apr 26 '23 14:04 marcingrzejszczak