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