Search Postgresql Archives

Re: postgresql book - practical or something newer?

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

 



On Mon, 4 Feb 2008, Dave Page wrote:

On Feb 4, 2008 3:48 PM, vincent <vinny@xxxxxxxxx> wrote:
So, let's do it community-style: wiki.

Thats what techdocs is for.
http://www.postgresql.org/docs/techdocs
Feel free to write new articles or improve what is there already.

Techdocs is a functional site to post completed articles. The level of work and administration involved in making even simple edits, combined with the lack of tools for managing what other people are doing, make it dramatically less productive for collaborative projects than true Wiki tools like the Mediawiki used on the developer's site. Examples of issues that slow things down considerably are the whole save before preview model of techdocs and problems that creep in if you switch between its limited WYSIWIG editor and the HTML editor extensively (just the fact that there is such a distinction is its own problem, and if you do all your work in the HTML version you are forced to switch between then). The main thing it's completely missing is a trivial to use diff and revert. Sadly some people just don't know what they should and shouldn't be changing, and it's highly useful for tracking what the other good people are doing once the pages get bigger if you want to keep general progress going forward in a consistant way.

It may be possible to build some new community-generated "not the manual" documentation on a real Wiki platform. I think hobbling it with the restrictions of techdocs would be a fatal to such a project.

How hard would it be to clone the configuration of the developer's wiki and make a new page like it for this purpose, something like userdocs.postgresql.org?

--
* Greg Smith gsmith@xxxxxxxxxxxxx http://www.gregsmith.com Baltimore, MD

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

[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