Re: [RFC] [Discussion] Using and Mentioning Third-party Packages in PHP Documentation and Web Projects

> > What a couple of people have touched on is that that all we have > right now is a Reference, which is only one kind of documentation.  > The common zeitgeist these days says there's 4: > https://diataxis.fr/ > > * Tutorials > * How-to guides > * Explanation > * Reference > > We have a reference with gaps, and that's about it.  In practice, it > will be functionally impossible to write a meaningful tutorial or > how-to guide that never mentions anything but php-src-provided code.  > Or at least the result would be sub-standard and doing the reader a > disservice. > > 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. > > 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. > Since we are talking about 3rd party tools, is "documentation" not a tool? Could we have a section for "further learning" that links to books and websites?