Hi,
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.
Jim
On 26 July 2024 21:39:38 BST, Jim Winstead <jimw@trainedmonkey.com> wrote:
Hi,
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.
Remove frontpage authors and editors by haszi · Pull Request #3468 · php/doc-en · GitHub
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.
Jim
There is a similar issue in PHP's credits. It's well outdated.
cheers
Derick
On Fri, Jul 26, 2024, at 1:43 PM, Derick Rethans wrote:
On 26 July 2024 21:39:38 BST, Jim Winstead <jimw@trainedmonkey.com> wrote:
Hi,
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.
Remove frontpage authors and editors by haszi · Pull Request #3468 · php/doc-en · GitHub
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.
Jim
There is a similar issue in PHP's credits. It's well outdated.
Sure, but I think that's out of scope for phpdoc@ to settle, so let's not conflate the two issues.
Jim
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.
Remove frontpage authors and editors by haszi · Pull Request #3468 · php/doc-en · GitHub
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
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.
Remove frontpage authors and editors by haszi · Pull Request #3468 · php/doc-en · GitHub
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