> On 31. Jan 2022, at 17:27, Julian Reschke <julian.resc...@gmx.de> wrote:
>
> Am 31.01.2022 um 16:50 schrieb Konrad Windszus:
>> Hi,
>> What happened to https://jackrabbit.apache.org/oak/docs/apidocs/?
>> It now only contains some shell script and options containing absolute
>> filesystem paths from Marcel Reutegger's local machine
>> (https://jackrabbit.apache.org/oak/docs/apidocs/options).
>> Can we publish the most recent release again?
>
> Yes. Something apparently went wrong.
>
> I would fix it, but can't do so quicky as the Oak documentation build is
> broken on Windows.
>
>> This is particularly crucial as the Jackrabbit API is no longer published at
>> https://jackrabbit.apache.org/api/trunk/. Publishing the javadoc is part of
>> our release process documented at
>> https://jackrabbit.apache.org/jcr/creating-releases.html#Part_II:_after_the_release_vote
>> step 9 IIUC.
>
> Well, that part is about Jackrabbit, not Oak.
Hm, IIUC the release documentation covers both Oak and Jackrabbit and step 9 is
not for Jackrabbit particularly, it just mentions:
"If the release was a stable release for which we publish API docs”
That should be clarified if it only refers to Jackrabbit
>
> AFAIU, the Oak side is happy to rely on javadoc.io, so does
> https://www.javadoc.io/doc/org.apache.jackrabbit/oak-jackrabbit-api/latest/index.html
> work for you maybe?
The problem is that there is no aggregate Javadoc and the links in
https://jackrabbit.apache.org/oak/docs/oak_api/overview.html are lacking the
javadoc.io link for oak-jackrabbit-api and still contain a link to
https://jackrabbit.apache.org/oak/docs/apidocs/.
BTW: event https://jackrabbit.apache.org/oak/docs/ is neither the latest
release (1.42) nor the latest snapshot (1.43-SNAPSHOT) but just an outdated
snapshot. I don’t see that step documented though at
https://jackrabbit.apache.org/jcr/creating-releases.html#Part_II:_after_the_release_vote.
Is there another release process page for Oak?
>
> Best regards, Julian
