[
https://issues.apache.org/jira/browse/JCR-4732?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17439069#comment-17439069
]
Konrad Windszus edited comment on JCR-4732 at 11/5/21, 8:35 AM:
----------------------------------------------------------------
INFRA fixed deep linking and I prepared a PR for Oak:
https://github.com/apache/jackrabbit-oak/pull/409/files and a patch for
Jackrabbit: [^JCR-4732-1.0.patch]
was (Author: kwin):
INFRA fixed deep linking and I prepared a PR for Oak:
https://github.com/apache/jackrabbit-oak/pull/409/files
> Host JCR 2.0 spec and its javadoc below https://jackrabbit.apache.org
> ---------------------------------------------------------------------
>
> Key: JCR-4732
> URL: https://issues.apache.org/jira/browse/JCR-4732
> Project: Jackrabbit Content Repository
> Issue Type: Improvement
> Components: docs
> Reporter: Konrad Windszus
> Priority: Major
> Attachments: JCR-4732-1.0.patch
>
>
> 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)).
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
