Hi dev,
We currently have two steps in the release plan which consist in updating links leading to the javadoc of:
- the
xwiki-platform
modules - the
xwiki-rendering-api
(why only this one ? history and never re-discussing that)
Those links honestly don’t add much value, especially since we have a helper to get the exact the same thing just by indicating any version you want in the case of xwiki-platform
modules.
1. https://www.xwiki.org/xwiki/bin/view/Documentation/DevGuide/API/
- remove the link to specific versions in the
JavaDoc
section and only keep the form (but obviously without the “Older version” label) - link all modules, and not just
xwiki-platform
modules, since that does not make any sense
2. https://rendering.xwiki.org/xwiki/bin/view/Main/JavaDoc
I’m tempted to propose to just completely get rid of that one, but choose between two possibilities:
- a. just remove it and link to https://www.xwiki.org/xwiki/bin/view/Documentation/DevGuide/API/ instead in https://rendering.xwiki.org/xwiki/bin/view/Main/
- b. convert it into something similar to https://www.xwiki.org/xwiki/bin/view/Documentation/DevGuide/API/, but with only rendering modules (and all of them this time)
WDYT ?
Here is my +1 for 1.
and 2.a
, and I won’t oppose 2.b
if others really insist on keeping it. I don’t really see much value in this xwiki-rendering
javadoc page compared to the all modules one, especially since we don’t have one for xwiki-commons
.