web icon indicating copy to clipboard operation
web copied to clipboard

Incorrect statements about release man pages

Open paulidale opened this issue 2 years ago • 5 comments

The Documentation page states:

The manual pages for all supported releases are available.

Clicking through reads thus:

The manual pages for all releases are available online:

[master](https://www.openssl.org/docs/manmaster)
[3.1](https://www.openssl.org/docs/man3.1)
[3.0](https://www.openssl.org/docs/man3.0)
[1.1.1](https://www.openssl.org/docs/man1.1.1)
[1.0.2](https://www.openssl.org/docs/man1.0.2)

The first statement is incorrect because we include more than just supported releases. The second is incorrect because not all releases are included.

I'm not advocating the removal of any of the man pages, just tightening the wording in both cases. To what eludes me currently.

paulidale avatar Sep 22 '23 02:09 paulidale

So, I guess it should be something like "for current development as well as all supported releases". That would fit what we put on display, no?

(3.2 in alpha state is still "current development")

levitte avatar Sep 22 '23 05:09 levitte

1.1.1 and 1.0.2 are no longer supported releases (at least for the vast majority of people who'll stumble over this).

paulidale avatar Sep 22 '23 05:09 paulidale

I'd like to argue that they are supported, just not for free. But hey, if you want to be wordy, how about "for current development as well as all supported (publicly or through premium support) releases".

levitte avatar Sep 22 '23 06:09 levitte

"The manual pages for all supported and some older releases are available."

mattcaswell avatar Sep 22 '23 08:09 mattcaswell

@mattcaswell, that's the wording I couldn't figure out.

paulidale avatar Sep 22 '23 08:09 paulidale