You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jackrabbit.apache.org by "Konrad Windszus (Jira)" <ji...@apache.org> on 2021/11/05 07:45:00 UTC
[jira] [Updated] (JCR-4732) Host JCR 2.0 spec and its javadoc below
https://jackrabbit.apache.org
[ https://issues.apache.org/jira/browse/JCR-4732?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Konrad Windszus updated JCR-4732:
---------------------------------
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/index.html (redirected)
# 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/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/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)).
was:
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/index.html (redirected)
# 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/maven/javax.jcr/javadocs/jcr-2.0/ (broken)
# 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)).
> 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
>
> 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/index.html (redirected)
> # 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/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/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)