Search Postgresql Archives

Re: [DOCS] COPY command documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thursday 23 March 2006 15:12, David Fetter wrote:
> On Thu, Mar 23, 2006 at 07:00:13PM +0100, Jim Nasby wrote:
> > On Mar 23, 2006, at 4:08 PM, Oisin Glynn wrote:
> > >I just discovered that the comments from 8.0 had the answer I was
> > >looking for but these comments are not in the 8.1 docs. Should the
> > >comments be rolled forward as new versions are created? Or if valid
> > >comments added to the docs themselves?
> > >
> > >http://www.postgresql.org/docs/8.1/interactive/sql-copy.html
> > >
> > >http://www.postgresql.org/docs/8.0/interactive/sql-copy.html
> >
> > No, comments don't roll forward.
>

The general consensus is that comments should not automatically roll forward, 
since many comments are version specific.  People are of course free to 
repost comments if they find them appropriate. 

> ...and it's unlikely that they will, now or later, without somebody
> whose whole job is to monitor those comments and make patches.
>

Well, we do make some attempt at rolling comments into the docs where 
appropriate, but we could certainly use more dedicated contributors in that 
area.  


> I'd like to make a Modest Proposalâ?¢:  Let's take down the interactive
> documents and, in their place, put up a request that doc patches be
> sent to -docs.
>
> What say?
>

I'd say you're anti-interactive comments :-)

More importantly, people just aren't going to to write patches for doc 
additions... the overhead is several orders of magnitudes greater than 
filling at a web form... so getting rid of the comments is sure to lose any 
gains that we receive.   

What I have tried to garner support for in the past was to either direct those 
submission to this group for approval/rejection, which would make the folks 
generally interested in docs directly involved in the process. 

The other option would be to mail approved doc comments to this group so that 
someone could work them up into doc patches if applicable. That really is a 
factor, most of the comments would need to be reworded to be added into the 
docs proper. 

In the past these ideas were rejected as either off-topic or that it would 
turn this list into a high traffic list... if peoples opinions have changed, 
it could be arranged. 

-- 
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Postgresql Jobs]     [Postgresql Admin]     [Postgresql Performance]     [Linux Clusters]     [PHP Home]     [PHP on Windows]     [Kernel Newbies]     [PHP Classes]     [PHP Books]     [PHP Databases]     [Postgresql & PHP]     [Yosemite]
  Powered by Linux