Details
-
Improvement
-
Status: Closed
-
Major
-
Resolution: Fixed
-
None
-
None
-
None
Description
The only reliable online hosting location of the JCR 2.0 specification and its javadoc has been Day/Adobe (apart from JSR which only provides the spec as zipped archive). As the URLs changed quite often from
- http://www.day.com/specs/jcr/2.0/ (broken)
- https://docs.adobe.com/content/docs/en/spec/jcr/2.0/ (redirected)
- https://docs.adobe.com/docs/en/spec/jcr/2.0/
- https://www.adobe.io/experience-manager/reference-materials/spec/jcr/2.0/index.html (seems to be the current one for JCR 2.0 spec)
and
- http://www.day.com/specs/javax.jcr/javadocs/jcr-2.0/ (broken)
- http://www.day.com/specs/javax.jcr/javadocs/jcr-1.0/
- http://www.day.com/maven/jsr170/javadocs/jcr-1.0/
- http://www.day.com/maven/javax.jcr/javadocs/jcr-2.0/ (broken)
- https://docs.adobe.com/content/docs/en/spec/jsr170/javadocs/jcr-2.0/
- https://docs.adobe.com/docs/en/spec/jsr170/javadocs/jcr-2.0/
- https://docs.adobe.com/docs/en/spec/javax.jcr/javadocs/jcr-2.0/
- https://www.adobe.io/experience-manager/reference-materials/spec/javax.jcr/javadocs/jcr-2.0/
- https://www.adobe.io/experience-manager/reference-materials/spec/jsr170/javadocs/jcr-2.0/
We maintain a lot of references towards it in our documentation, instead of adjusting the URLs each time, we should host that in our own ASF website under a stable URL.
The download from http://jcp.org/aboutJava/communityprocess/final/jsr283/index.html only contains a Word document and a PDF of the spec though, so one needs to somehow convert to html.
Although hosting the javadoc is straightforward it might be nice to apply some fixes (e.g. unclosed code tag in https://www.adobe.io/experience-manager/reference-materials/spec/jsr170/javadocs/jcr-2.0/javax/jcr/Session.html#getNodeByIdentifier(java.lang.String)).
Attachments
Attachments
Issue Links
- is related to
-
JCR-5041 Javadoc build is broken due to JCR 2.0 API docs being unavailable
-
- Closed
-
-
-
- Resolved
-
-
-
- Closed
-
- links to