You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Elric V <el...@melnib.one> on 2026/05/31 12:54:38 UTC
[CLI] Broken links on CLI site
Hi folks,
Back in November Gary kindly merged a patch which fixed some broken
links on the Commons CLI site, but it looks like the links are still
broken. Is it possible that the site simply hasn't been redeployed since
then?
Basically the links to the user guide from the front page are broken:
https://commons.apache.org/proper/commons-cli/
The patch in question:
https://github.com/apache/commons-cli/pull/417/changes
Can someone with the appropriate permissions redeploy the site?
One day I will simply remember the API and I won't have to reread the
introduction again. But not today.
Thanks,
- Elric
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [CLI] Broken links on CLI site
Posted by Alex Herbert <al...@gmail.com>.
On Sun, 31 May 2026 at 13:55, Elric V <el...@melnib.one> wrote:
> Hi folks,
>
> Back in November Gary kindly merged a patch which fixed some broken
> links on the Commons CLI site, but it looks like the links are still
> broken. Is it possible that the site simply hasn't been redeployed since
> then?
>
> Basically the links to the user guide from the front page are broken:
>
> https://commons.apache.org/proper/commons-cli/
>
> The patch in question:
> https://github.com/apache/commons-cli/pull/417/changes
>
> Can someone with the appropriate permissions redeploy the site?
>
Updated as per the patch for the main links in the site homepage
(index.html).
Note that the user guide links in the left menu were correct.
Alex
>
> One day I will simply remember the API and I won't have to reread the
> introduction again. But not today.
>
> Thanks,
>
> - Elric
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>
Re: [CLI] Broken links on CLI site + PR
Posted by Elric V <el...@melnib.one>.
Looks like I sent this prematurely, discoverd a few more issues in the
docs, so I created a patch to address some more broken links and
deprecated method usage in the documentation.
This also (re-?)adds an overloaded method in HelpFormatter which was
omitted when the newer implementation was created in the
org.apache.commons.cli.help package. The overloaded method is a lot
simpler to call, and it fixes a part of the documentation that was
broken (because it was using the old syntax which will now work again).
I'm not sure if I fixed the broken links in the right way. It seems like
the old links might have been meant to point at the latest release:
javadocs/api-release, but as near as I can tell no versioned javadocs
are published, so those links now all point at apidocs/ and seem to work.
PR is available on github:
https://github.com/apache/commons-cli/pull/424/changes
Thanks,
- Elric
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org