Re: Removing authors and editors from the documentation front page

[email protected] ("Christoph M. Becker") Fri, 26 Jul 2024 23:26:20 +0200
Newsgroups php.doc
Message-ID <[email protected]>
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