Re: Missing link in Developer FAQ - Mailing list pgsql-www

From Bruce Momjian
Subject Re: Missing link in Developer FAQ
Date
Msg-id 20120904163923.GB9476@momjian.us
Whole thread Raw
In response to Re: Missing link in Developer FAQ  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Missing link in Developer FAQ
List pgsql-www
On Sun, Sep  2, 2012 at 09:37:48AM -0400, Bruce Momjian wrote:
> > AFAICT, the last time anybody actually did anything but fix typos in
> > it was in 2008. So I think that "stay in sync" argument is not really
> > relevant.
> > 
> > 
> > >> Also, it took almost a year for anybody to notice that they weren't
> > >> there, so they're clearly not used very much.
> > >
> > > I think it's not visible enough.  We have plenty of new people trying to
> > > understand the PG innards all the time that it remains a useful
> > > resource.
> > 
> > Oh, I'm not saying we should get rid of it. Just migrate it to a
> > better position. If we put it "properly on the website" it would
> > probably get *more* exposure, rather than less...
> 
> I am ready to work on this.  The flowchart has three parts:
> 
> 1)  the image, with hot clickable areas --- I assume this can't be done
> in a wiki and has to be on our website.
> 
> 2)  text for clickable links in #1 --- needs either a wiki page for
> every entry or an html 'id' that allows us to scroll to the desired
> entry. This can be done on the wiki.  Would be nice to add links to the
> README files in specific directories too.
> 
> 3)  links from the #2 text to the git source code tree, e.g.
> http://git.postgresql.org/gitweb/?p=postgresql.git;a=tree;f=src/backend/commands
> 
> Who can help me setup #1 and I can do #2 and #3?  I need a web directory
> to hold the image and the ability to edit the HTML to link properly to
> the wiki.

OK, updated flowchart now online:
http://www.postgresql.org/developer/backend/

While the main page requires a patch to modify, the wiki it links to can
be modified by anyone with a wiki account.

I have removed src/tools/backend from git now that we are hosting it
elsewhere.

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.com
 + It's impossible for everything to be true. +



pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: searching for git commit hash
Next
From: Josh Kupershmidt
Date:
Subject: Re: [DOCS] Confusion over "This page in other versions" links