Re: Removing authors and editors from the documentation front page

[email protected] ("Larry Garfield") Sat, 27 Jul 2024 07:45:11 -0500
Newsgroups php.doc
Message-ID <[email protected]>
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