Greetings, * Benjamin Scherrey (scherrey@xxxxxxxxxxxxxxxx) wrote: > One thing I recall very fondly about the early days of the Lamp stack was > that the official documentation of PHP and MySQL was augmented with user > created practical examples. It was still reference documentation organized > by command or function, but in a comment-like section underneath the formal > docs were user provided short practical examples of how the command would > be used in real situations. One was able to teach themselves how to build a > dynamic website front ending a database just by exploring the core docs and > reading the examples. We have a place for this to go, in the official docs, already split out by version, and it starts here: https://www.postgresql.org/docs/10/static/tutorial-start.html Adding more to that certainly sounds good to me. So, for my 2c, at least, "patches welcome." Drive-by comments saying that we need a place for this, when we already have one, and saying that the community should develop it, while not acknowledging or contributing to what we already have, does not strike me as particularly useful. We tried having a comment area on the docs and those ultimately ended up being... less than ideal. I'm not anxious to repeat that experiment. I'm glad it worked for other communities, but it didn't work for us and we have a good bit of history to show that. The best way to improve that section of the docs is to write up good user example-based documentation and submit it as patches. I'd certainly be happy to see that and to try and help by moving such patches forward to commit. Thanks! Stephen
Attachment:
signature.asc
Description: PGP signature
