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....xing_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

---------------------------(end of broadcast)---------------------------
TIP 2: Don't 'kill -9' the postmaster

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

---------------------------(end of broadcast)---------------------------
TIP 5: don't forget to increase your free space map settings

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

---------------------------(end of broadcast)---------------------------
TIP 6: explain analyze is your friend

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

---------------------------(end of broadcast)---------------------------
TIP 1: if posting/reading through Usenet, please send an appropriate
subscribe-nomail command to majordomo@postgresql.org so that your
message can get through to the mailing list cleanly

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

---------------------------(end of broadcast)---------------------------
TIP 6: explain analyze is your friend