Обсуждение: PostgreSQL Docs - Community Documentation
Last month there was a discussion about how it would be nice to have a place people would write user-oriented documentation at with more flexibility than the current Techdocs site offers. I ran with that idea and there is now such a site available at http://www.postgresqldocs.org You will need to create an account in order to submit edits, but there's no approval process; you'll get in instantly. Submissions are accepted under the Creative Commons Attribution license. I put in an initial outline to organize things and filled in enough articles that there's already useful content there. What I plan to do is take all these archived e-mails I have from interesting list discussions and summarize a chunk of them every week onto articles there, like General Bits used to do (with the difference that as people notice issues with the suggestions it's easy to improve them). An example of that I'd suggest as a reasonable format to follow for that sort of thing is at http://www.postgresqldocs.org/index.php/Fixing_Sequences Thanks to Joshua Drake and Command Prompt for providing hosting space and even having an appropriate domain. To cut off one question I expect to pop up, yes it would be nice to have this integrated with the main postgresql.org site and its existing account structure. But since Joshua was the only person who answered my request for hosting space I used the server he volunteered. We'd be glad to move this to somewhere more official if that were available, I'm focused on creating the content and don't care where it lives at. -- * Greg Smith gsmith@gregsmith.com http://www.gregsmith.com Baltimore, MD
Greg Smith wrote: > Thanks to Joshua Drake and Command Prompt for providing hosting space > and even having an appropriate domain. To cut off one question I expect > to pop up, yes it would be nice to have this integrated with the main > postgresql.org site and its existing account structure. But since > Joshua was the only person who answered my request for hosting space I > used the server he volunteered. We'd be glad to move this to somewhere > more official if that were available, I'm focused on creating the > content and don't care where it lives at. Greg et al, thanks very much for taking this idea and making it a reality. Since I was one of the ones who requested it, I'll sign up for an account right away (done). Regarding "where it lives", what is the constraint that prevents it from residing on the main site? Space? Money? I see one addition that would be helpful to newcomers to this tool such as myself. The Main Page jumps right into the PG related material; "Getting Started" refers to getting started with PG, not with getting started contributing to the community documentation. I discovered that clicking the "About PostreSQL Docs" link on the bottom of the page produces a short intro to the purpose of the site. Could we also get added to this page a sentence or two about the software that runs the site, and a pointer to documentation on that software? I know, I know, this is "user-contributed" documentation, so I'm free to add that myself. Hopefully you appreciate my Catch-22 ;). "About PostgreSQL Docs" is an important topic, and should be elevated to the same list as "Main Page". -- Guy Rouillier
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Mon, 03 Mar 2008 00:47:09 -0500 Guy Rouillier <guyr-ml1@burntmail.com> wrote: > Greg et al, thanks very much for taking this idea and making it a > reality. Since I was one of the ones who requested it, I'll sign up > for an account right away (done). Regarding "where it lives", what > is the constraint that prevents it from residing on the main site? > Space? Money? Logistics. That's it. It will happen when people have time or desire. The main site has more than enough hardware (but we can always use more). http://www.postgresql.org/about/servers Sincerely, Joshua D. Drake - -- The PostgreSQL Company since 1997: http://www.commandprompt.com/ PostgreSQL Community Conference: http://www.postgresqlconference.org/ Donate to the PostgreSQL Project: http://www.postgresql.org/about/donate PostgreSQL SPI Liaison | SPI Director | PostgreSQL political pundit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) iD4DBQFHy5oPATb/zqfZUUQRAjedAJUfRN21378FgWYEEIbxO79roQyaAJwKkxai y9mcvZYmXgqka/uZe0ansA== =4IeE -----END PGP SIGNATURE-----
On Mon, Mar 3, 2008 at 5:47 AM, Guy Rouillier <guyr-ml1@burntmail.com> wrote: > Greg Smith wrote: > > > Thanks to Joshua Drake and Command Prompt for providing hosting space > > and even having an appropriate domain. To cut off one question I expect > > to pop up, yes it would be nice to have this integrated with the main > > postgresql.org site and its existing account structure. But since > > Joshua was the only person who answered my request for hosting space I > > used the server he volunteered. We'd be glad to move this to somewhere > > more official if that were available, I'm focused on creating the > > content and don't care where it lives at. > > Greg et al, thanks very much for taking this idea and making it a > reality. Since I was one of the ones who requested it, I'll sign up for > an account right away (done). Regarding "where it lives", what is the > constraint that prevents it from residing on the main site? Space? Money? A postgresql.org wiki to replace techdocs is being worked on, per recent discussion on -www, however it takes a little more effort than a standalone one as we need to integrate it properly into the existing infrastructure. -- Dave Page EnterpriseDB UK Ltd: http://www.enterprisedb.com PostgreSQL UK 2008 Conference: http://www.postgresql.org.uk
Dave Page wrote: > A postgresql.org wiki to replace techdocs is being worked on, per > recent discussion on -www, however it takes a little more effort than > a standalone one as we need to integrate it properly into the existing > infrastructure. Dave, what is the intention of this wiki, as opposed to the Community Documentation that just got kicked off? -- Guy Rouillier
On Mon, Mar 3, 2008 at 6:13 PM, Guy Rouillier <guyr-ml1@burntmail.com> wrote: > Dave Page wrote: > > > A postgresql.org wiki to replace techdocs is being worked on, per > > recent discussion on -www, however it takes a little more effort than > > a standalone one as we need to integrate it properly into the existing > > infrastructure. > > Dave, what is the intention of this wiki, as opposed to the Community > Documentation that just got kicked off? A replacement for Techdocs. The project that just got kicked off is not a postgresql.org project, nor is it run by the project's web/sysadmin teams. -- Dave Page EnterpriseDB UK Ltd: http://www.enterprisedb.com PostgreSQL UK 2008 Conference: http://www.postgresql.org.uk