Publish the spec and javadoc

[FroMage]

We should put the (rendered) spec and javadoc online somewhere because ATM it's impossible to link to them.

Is there any formal placement for those @kenfinnigan ?

[kenfinnigan]

Not sure if anything is done at the platform level.

@kwsutter?

[njr-11]

When going through the release candidate process, it had me attach the spec (which I did as pdf and html form) to the git release,
https://github.com/eclipse/microprofile-context-propagation/releases/tag/1.0-RC2

However, even the html doc here seems to function as a download rather than displaying in a browser, and this doesn't address the JavaDoc at all.

When browsing through the spec doc, I noticed several broken links from the release notes section,
http://download.eclipse.org/microprofile/microprofile-context-propagation-1.0/microprofile-context-propagation.pdf
http://download.eclipse.org/microprofile/microprofile-context-propagation-1.0/microprofile-context-propagation.html
http://download.eclipse.org/microprofile/microprofile-context-propagation-1.0/apidocs/

I suspect these links are broken because they are anticipating the location for the final released version of the spec, and we are still in release candidate.

That said, backing up from this location, I found the following for 1.0 RC 2,

https://download.eclipse.org/microprofile/microprofile-context-propagation-1.0-RC2

which has both the JavaDoc and the spec (both as html and pdf) which is directly viewable in a browser rather than as a download like the git releases.

[aguibert]

@FroMage We have our javadoc automatically rendered here: https://javadoc.io/doc/org.eclipse.microprofile.context-propagation/microprofile-context-propagation-api/1.0-RC2

If you go to the top of the README for this repo, there is a green "[javadoc | 1.0-RC2]" badge at the top, next to the other badges, which you can click on to get to the javadoc.

[aguibert]

Also, it would be nice if the microprofile.io website could have links to all the javadoc/spec docs for all of the various components, so users don't need to go fishing around in github repos or other sites.

[njr-11]

Also, it would be nice if the microprofile.io website could have links to all the javadoc/spec docs for all of the various components, so users don't need to go fishing around in github repos or other sites.

Given that, does this issue need to be raised against a different repository?