Re: Removing authors and editors from the documentation front page
| From: | Larry Garfield | Date: | Sat, 27 Jul 2024 12:45:11 +0000 |
| Subject: | Re: Removing authors and editors from the documentation front page | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969388390@lists.php.net to get a copy of this message | ||
On Fri, Jul 26, 2024, at 4:26 PM, Christoph M. Becker wrote:
> On 26.07.2024 at 22:39, Jim Winstead wrote:
>
>> There's a PR to remove the authors and editors from the front page of the
>> documentation, and it was suggested to bring discussion of that here.
>>
>> https://github.com/php/doc-en/pull/3468
>>
>> As someone who long ago got demoted off the front page, I think it makes sense at this
>> point to just not have anyone on the front page and leave it to the longer lists in the preface.
>
> I still think that it's a very good idea to remove this list from the
> front page, not only because it is outdated, and it doesn't necessarily
> reflect the impact of the listed contributors, but maybe most
> importantly because that info just doesn't belong there. Users want to
> see the TOC, and not a list of contributors. I would also remove the
> copyright line there, since the first item in the TOC is the "Copyright"
> section (and even that link should be moved towards the end of TOC, in
> my opinion).
>
> Cheers,
> Christoph
I concur. It's not accurate, and figuring out what an accurate list would be invites all kinds
of politics we don't want. Let's just remove it.
--Larry Garfield