Re: [RFC] [Discussion] Using and Mentioning Third-party Packages in PHP Documentation and Web Projects
| From: | John Coggeshall | Date: | Wed, 28 Aug 2024 16:09:48 +0000 |
| Subject: | Re: [RFC] [Discussion] Using and Mentioning Third-party Packages in PHP Documentation and Web Projects | ||
| References: | 1 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-125340@lists.php.net to get a copy of this message | ||
On Aug 28 2024, at 9:34 am, Larry Garfield <larry@garfieldtech.com> wrote:
>
> I don't think I'd support a list of "popular" frameworks, but mentioning
> Composer, Xdebug, and PHPUnit seems a requirement for a useful modern tutorial.
Can you explain your position more here, what exactly is your concern (if I captured it in my
previous email -- why do you think I'm off base to say we're over-estimating the
importance)?
> Admittedly, the docs team is very under-resourced right now and even the reference section has
> not-small holes, making maintaining even more types of documentation a potential challenge.
> That's something the Foundation could possibly help with. But that's not the topic at
> hand: The topic at hand is just "look, we should be able to mention Composer, Xdebug, and
> PHPUnit, OK?" On which I very much am in agreement.
That's not the topic at hand -- the topic at hand is adopting the principle that:
"The web and documentation projects within the PHP Project can use or document the existence of
third-party PHP projects as part of their roles in supporting the overall PHP community. Such use
does not represent endorsement of those third-party projects by the PHP Project."
So that would include frameworks, etc. alongside composer, phpunit, etc.