Re: Re: [COMMITTERS] pgsql: Add: > o Add SQLSTATE severit yto PGconn return status > >

Started by Magnus Haganderalmost 18 years ago26 messages
#1Magnus Hagander
magnus@hagander.net

How about we move it to the wiki. AFAIK we can still lock it down to who
can edit it if we want to

You should confirm you can get the editing granularity you want before
making too many plans here if this is important. The features for locking
down things in Mediawiki are very limited.

The Wiki philosophy here is that you could revert quite a few bad changes
in the time it would take you to lock it down so those bad changes could
never happen in the first place. Last time I checked vandalism and bad
edits were not a problem on the developer's wiki.

It's not. And I personally don't think it would be a problem. But I think it'll be a lot easier to sell to those who prefer textfiles in cvs (hello bruce!) if we can.

/Magnus

#2Bruce Momjian
bruce@momjian.us
In reply to: Magnus Hagander (#1)
Re: Re: [COMMITTERS] pgsql: Add: > o Add SQLSTATE severit yto PGconn return status > >

Magnus Hagander wrote:

How about we move it to the wiki. AFAIK we can still lock it down to who
can edit it if we want to

You should confirm you can get the editing granularity you want before
making too many plans here if this is important. The features for locking
down things in Mediawiki are very limited.

The Wiki philosophy here is that you could revert quite a few bad changes
in the time it would take you to lock it down so those bad changes could
never happen in the first place. Last time I checked vandalism and bad
edits were not a problem on the developer's wiki.

It's not. And I personally don't think it would be a problem.
But I think it'll be a lot easier to sell to those who prefer
textfiles in cvs (hello bruce!) if we can.

I don't care who edits it myself, though I can say I get perhaps one
patch a year to the TODO list file --- usually I just an email saying
remove that item or something.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#3Alvaro Herrera
alvherre@commandprompt.com
In reply to: Bruce Momjian (#2)
Re: Re: [COMMITTERS] pgsql: Add: > o Add SQLSTATE severit yto PGconn return status > >

Bruce Momjian wrote:

Magnus Hagander wrote:

It's not. And I personally don't think it would be a problem.
But I think it'll be a lot easier to sell to those who prefer
textfiles in cvs (hello bruce!) if we can.

I don't care who edits it myself, though I can say I get perhaps one
patch a year to the TODO list file --- usually I just an email saying
remove that item or something.

Personally I've wished to enter something in the TODO list myself but
refrained because it was "your area". Having a derived HTML page
doesn't make me feel any better -- how should I generate it to ensure
that my output is equal to yours?

--
Alvaro Herrera http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

#4Bruce Momjian
bruce@momjian.us
In reply to: Alvaro Herrera (#3)
Re: Re: [COMMITTERS] pgsql: Add: > o Add SQLSTATE severit yto PGconn return status > >

Alvaro Herrera wrote:

Bruce Momjian wrote:

Magnus Hagander wrote:

It's not. And I personally don't think it would be a problem.
But I think it'll be a lot easier to sell to those who prefer
textfiles in cvs (hello bruce!) if we can.

I don't care who edits it myself, though I can say I get perhaps one
patch a year to the TODO list file --- usually I just an email saying
remove that item or something.

Personally I've wished to enter something in the TODO list myself but
refrained because it was "your area". Having a derived HTML page
doesn't make me feel any better -- how should I generate it to ensure
that my output is equal to yours?

If you change the text file, I will see the CVS update and update the
HTML --- I will never lose a change because my CVS sees your changes.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#5Magnus Hagander
magnus@hagander.net
In reply to: Bruce Momjian (#4)
TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 10:27:06AM -0400, Bruce Momjian wrote:

Alvaro Herrera wrote:

Bruce Momjian wrote:

Magnus Hagander wrote:

It's not. And I personally don't think it would be a problem.
But I think it'll be a lot easier to sell to those who prefer
textfiles in cvs (hello bruce!) if we can.

I don't care who edits it myself, though I can say I get perhaps one
patch a year to the TODO list file --- usually I just an email saying
remove that item or something.

Personally I've wished to enter something in the TODO list myself but
refrained because it was "your area". Having a derived HTML page
doesn't make me feel any better -- how should I generate it to ensure
that my output is equal to yours?

If you change the text file, I will see the CVS update and update the
HTML --- I will never lose a change because my CVS sees your changes.

That seems like a lot of extra work that should be unnecessary.

I asked before for general reactions, so I will now turn that into a formal proposal:

Let's move the TODO list to the wiki. Bruce still retains "ownership" of it
and will certainly be doing most of the editing. But people who work on
individual items can add/remove items and details as needed directly on the
wiki as necessary.

Those who still need daily updates can easily grab an RSS feed off the
wiki, or use the watch feature (disclaimer: I haven't used the watch
feature myself, but I'm told it should work).

Can we get a soundoff on this? Good idea, bad idea?

(if we decide to do it, we'll have to migrate what's there now, of course.
But I'm sure we can find volounteer(s) to help with that so Bruce doesn't
have to do all the work.)

//Magnus

#6Bruce Momjian
bruce@momjian.us
In reply to: Magnus Hagander (#5)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Magnus Hagander wrote:

If you change the text file, I will see the CVS update and update the
HTML --- I will never lose a change because my CVS sees your changes.

That seems like a lot of extra work that should be unnecessary.

I asked before for general reactions, so I will now turn that into a formal proposal:

Let's move the TODO list to the wiki. Bruce still retains "ownership" of it
and will certainly be doing most of the editing. But people who work on
individual items can add/remove items and details as needed directly on the
wiki as necessary.

Those who still need daily updates can easily grab an RSS feed off the
wiki, or use the watch feature (disclaimer: I haven't used the watch
feature myself, but I'm told it should work).

Can we get a soundoff on this? Good idea, bad idea?

(if we decide to do it, we'll have to migrate what's there now, of course.
But I'm sure we can find volounteer(s) to help with that so Bruce doesn't
have to do all the work.)

We need it to do a few things:

o We need to be able to pull a text and HTML copies for tarballs
o Edits have to be quick and easy
o I have to be able to make new sections, and move existing
items around and between sections
o I need to be able to add URLs for items
o I need subsections and sub-subsections

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#7Magnus Hagander
magnus@hagander.net
In reply to: Bruce Momjian (#6)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 11:03:13AM -0400, Bruce Momjian wrote:

Magnus Hagander wrote:

If you change the text file, I will see the CVS update and update the
HTML --- I will never lose a change because my CVS sees your changes.

That seems like a lot of extra work that should be unnecessary.

I asked before for general reactions, so I will now turn that into a formal proposal:

Let's move the TODO list to the wiki. Bruce still retains "ownership" of it
and will certainly be doing most of the editing. But people who work on
individual items can add/remove items and details as needed directly on the
wiki as necessary.

Those who still need daily updates can easily grab an RSS feed off the
wiki, or use the watch feature (disclaimer: I haven't used the watch
feature myself, but I'm told it should work).

Can we get a soundoff on this? Good idea, bad idea?

(if we decide to do it, we'll have to migrate what's there now, of course.
But I'm sure we can find volounteer(s) to help with that so Bruce doesn't
have to do all the work.)

We need it to do a few things:

o We need to be able to pull a text and HTML copies for tarballs

That should be doable without too much work. I would, however, like to open
a second discussion on wether we actually *need* it. But that's a different
discussion than this - if we do need it, we can make that happen.

o Edits have to be quick and easy

That's the whole idea of a wiki. I don't personally love the markup
language, but for the simple kind of stuff that the TODO list deals with
(markup-wise), it's very easy to use.

o I have to be able to make new sections, and move existing
items around and between sections

Trivial - again, what a wiki does best. Look at for example
http://developer.postgresql.org/index.php/Replication%2C_Clustering%2C_and_Connection_Pooling
for a page taht has a bunch of different sections. It uses tables in some
and lists in some etc, but it shold give you an idea of how simple it is to
craete sections.

o I need to be able to add URLs for items

You maen links to external sites? Also trivial. Again, what a wiki is
designed for more or less.

o I need subsections and sub-subsections

Should be doable either as wiki sections or as bullet-lists.

//Magnus

#8Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#6)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Bruce Momjian <bruce@momjian.us> writes:

Magnus Hagander wrote:

Let's move the TODO list to the wiki.

We need it to do a few things:

o We need to be able to pull a text and HTML copies for tarballs

Why? Even if we think the TODO list needs to appear in tarballs (which
is hardly a given if you ask me), why the heck does it have to be in two
formats? AFAIK the only reason we bother with an HTML version is to
have something to put on the website, and this proposal supersedes that
aspect of things. ISTM a plain-text copy would be plenty.

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

regards, tom lane

#9Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#8)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Magnus Hagander wrote:

Let's move the TODO list to the wiki.

We need it to do a few things:

o We need to be able to pull a text and HTML copies for tarballs

Why? Even if we think the TODO list needs to appear in tarballs (which
is hardly a given if you ask me), why the heck does it have to be in two
formats? AFAIK the only reason we bother with an HTML version is to
have something to put on the website, and this proposal supersedes that
aspect of things. ISTM a plain-text copy would be plenty.

Fine with me.

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.
The current web version very soon doesn't match the major release they
are running, and I am unsure we want to have historical links for every
major release.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#10Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#9)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

In any case I've always thought that the TODO was developer-oriented
documentation, not something users would read. If there's a shortcoming
in a feature, it ought to be documented in the SGML manual.

regards, tom lane

#11Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#10)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

In any case I've always thought that the TODO was developer-oriented
documentation, not something users would read. If there's a shortcoming
in a feature, it ought to be documented in the SGML manual.

It typically isn't, except for major issues, again due to lack of
resources.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#12Tom Lane
tgl@sss.pgh.pa.us
In reply to: Magnus Hagander (#7)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Magnus Hagander <magnus@hagander.net> writes:

On Wed, Mar 12, 2008 at 11:03:13AM -0400, Bruce Momjian wrote:

We need it to do a few things:

Actually, the part of the current process that a wiki would fail to
reproduce is the emails that Bruce sends out about TODO changes.
Do we still want those, and if so what would we do about it?

Personally I think the current mails are overly verbose --- in
particular, quoting (one of the) referenced email messages is
good for nothing except archive-bloat. However going over to
nothing at all might be too far in the other direction.

regards, tom lane

#13Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#12)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Tom Lane wrote:

Magnus Hagander <magnus@hagander.net> writes:

On Wed, Mar 12, 2008 at 11:03:13AM -0400, Bruce Momjian wrote:

We need it to do a few things:

Actually, the part of the current process that a wiki would fail to
reproduce is the emails that Bruce sends out about TODO changes.
Do we still want those, and if so what would we do about it?

Magnus said you can subscribe to a changes email, or get an RSS feed of
changes.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#14Magnus Hagander
magnus@hagander.net
In reply to: Tom Lane (#12)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 11:36:52AM -0400, Tom Lane wrote:

Magnus Hagander <magnus@hagander.net> writes:

On Wed, Mar 12, 2008 at 11:03:13AM -0400, Bruce Momjian wrote:

We need it to do a few things:

Actually, the part of the current process that a wiki would fail to
reproduce is the emails that Bruce sends out about TODO changes.
Do we still want those, and if so what would we do about it?

Bruce still replies to all emails saying "Added to TODO". So you get *two*
copies of it every time this time - once on -hackers, -general or whatever,
and one on -committers.

You will also be able to subscruibe to updates on the wiki. The preferrable
way (at least for me, and I'm sure for a lot of folks) using RSS, but also
using email.

//Magnus

#15Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#13)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Actually, the part of the current process that a wiki would fail to
reproduce is the emails that Bruce sends out about TODO changes.
Do we still want those, and if so what would we do about it?

Magnus said you can subscribe to a changes email, or get an RSS feed of
changes.

Right, so people who were specifically interested in following TODO
changes could still track it. But the current system informs the
original submitter of a problem that it's been put on TODO, and that
wouldn't happen anymore. Do we care?

regards, tom lane

#16Dave Page
dpage@pgadmin.org
In reply to: Bruce Momjian (#11)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 3:32 PM, Bruce Momjian <bruce@momjian.us> wrote:

Tom Lane wrote:

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

Should we outsource it? It is user-facing :-p

--
Dave Page
EnterpriseDB UK Ltd: http://www.enterprisedb.com
PostgreSQL UK 2008 Conference: http://www.postgresql.org.uk

#17Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#15)
Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Actually, the part of the current process that a wiki would fail to
reproduce is the emails that Bruce sends out about TODO changes.
Do we still want those, and if so what would we do about it?

Magnus said you can subscribe to a changes email, or get an RSS feed of
changes.

Right, so people who were specifically interested in following TODO
changes could still track it. But the current system informs the
original submitter of a problem that it's been put on TODO, and that
wouldn't happen anymore. Do we care?

I would still send out an email for TODO additions based on the original
email.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#18Bruce Momjian
bruce@momjian.us
In reply to: Dave Page (#16)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Dave Page wrote:

On Wed, Mar 12, 2008 at 3:32 PM, Bruce Momjian <bruce@momjian.us> wrote:

Tom Lane wrote:

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

Should we outsource it? It is user-facing :-p

If it was a service we could use for free, we could consider it.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#19Joshua D. Drake
jd@commandprompt.com
In reply to: Bruce Momjian (#18)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Wed, 12 Mar 2008 12:10:27 -0400 (EDT)
Bruce Momjian <bruce@momjian.us> wrote:

It is a best effort with our limited resources.

Should we outsource it? It is user-facing :-p

If it was a service we could use for free, we could consider it.

https://launchpad.net/
http://www.sourceforge.net/

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 political pundit | Mocker of Dolphins

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFH2AW0ATb/zqfZUUQRAkLUAKCKbvUEQtG/KT8XrhrkB0/hdHUXqQCgnDTp
VTfGZSIFftAJqo3PSP4XOhE=
=N3tJ
-----END PGP SIGNATURE-----

#20Bruce Momjian
bruce@momjian.us
In reply to: Joshua D. Drake (#19)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Joshua D. Drake wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Wed, 12 Mar 2008 12:10:27 -0400 (EDT)
Bruce Momjian <bruce@momjian.us> wrote:

It is a best effort with our limited resources.

Should we outsource it? It is user-facing :-p

If it was a service we could use for free, we could consider it.

https://launchpad.net/
http://www.sourceforge.net/

Those are a step backward --- they don't have the functionality we
currently have, but have more functionality in other areas.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#21Joshua D. Drake
jd@commandprompt.com
In reply to: Bruce Momjian (#20)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Wed, 12 Mar 2008 12:39:06 -0400 (EDT)
Bruce Momjian <bruce@momjian.us> wrote:

If it was a service we could use for free, we could consider it.

https://launchpad.net/
http://www.sourceforge.net/

Those are a step backward --- they don't have the functionality we
currently have, but have more functionality in other areas.

First it was a joke. However I would be curious to know which features
you think they don't have. If nothing else Launchpad is a customer and
I can give them some feedback.

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 political pundit | Mocker of Dolphins

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD4DBQFH2AkAATb/zqfZUUQRAg99AJjaI+Ozx+LPRPezEpXLEgVeZyrXAJ962Jsa
khsonJQJfNYzmoYbOTHEsQ==
=i49i
-----END PGP SIGNATURE-----

#22Bruce Momjian
bruce@momjian.us
In reply to: Joshua D. Drake (#21)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Joshua D. Drake wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Wed, 12 Mar 2008 12:39:06 -0400 (EDT)
Bruce Momjian <bruce@momjian.us> wrote:

If it was a service we could use for free, we could consider it.

https://launchpad.net/
http://www.sourceforge.net/

Those are a step backward --- they don't have the functionality we
currently have, but have more functionality in other areas.

First it was a joke. However I would be curious to know which features
you think they don't have. If nothing else Launchpad is a customer and
I can give them some feedback.

Probably the biggest missing feature for the TODO is the ability to
summarize, group into labeled sections and subsections, and the ability
to move items around, with URL links to more detail. Effectively that
is all the TODO list is.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#23Alvaro Herrera
alvherre@commandprompt.com
In reply to: Bruce Momjian (#22)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Bruce Momjian wrote:

Probably the biggest missing feature for the TODO is the ability to
summarize, group into labeled sections and subsections, and the ability
to move items around, with URL links to more detail. Effectively that
is all the TODO list is.

Oh, like a Wiki page.

--
Alvaro Herrera http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

#24Magnus Hagander
magnus@hagander.net
In reply to: Bruce Momjian (#11)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 11:32:16AM -0400, Bruce Momjian wrote:

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

In any case I've always thought that the TODO was developer-oriented
documentation, not something users would read. If there's a shortcoming
in a feature, it ought to be documented in the SGML manual.

It typically isn't, except for major issues, again due to lack of
resources.

I think you will have to search for a long time to find anybody who
actually uses it like that. I'm willing to bet that well over 95% of the
people who read the TODO only read it on the website. (potentially
excluding the actual patch-contributors, but those aren't included in your
argument anyway)

//Magnus

#25Bruce Momjian
bruce@momjian.us
In reply to: Magnus Hagander (#24)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

Magnus Hagander wrote:

On Wed, Mar 12, 2008 at 11:32:16AM -0400, Bruce Momjian wrote:

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

In any case I've always thought that the TODO was developer-oriented
documentation, not something users would read. If there's a shortcoming
in a feature, it ought to be documented in the SGML manual.

It typically isn't, except for major issues, again due to lack of
resources.

I think you will have to search for a long time to find anybody who
actually uses it like that. I'm willing to bet that well over 95% of the
people who read the TODO only read it on the website. (potentially
excluding the actual patch-contributors, but those aren't included in your
argument anyway)

We can always remove it from the tarball and see if anyone complains.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#26Magnus Hagander
magnus@hagander.net
In reply to: Bruce Momjian (#25)
Re: Re: TODO-list on wiki (was: TODO update about SQLSTATE to PGconn)

On Wed, Mar 12, 2008 at 02:10:08PM -0400, Bruce Momjian wrote:

Magnus Hagander wrote:

On Wed, Mar 12, 2008 at 11:32:16AM -0400, Bruce Momjian wrote:

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> writes:

Tom Lane wrote:

Personally I think it would be just fine if we had only the wiki copy
and forgot about shipping it in tarballs.

The problem with not shipping the TODO file at all is that TODO gives
users a list of all known bugs/missing features in that major release.

This seems to me to be nonsense.  You've never maintained the
back-branch versions of the TODO list, so they're out of date anyway
--- ie, they don't account for problems discovered post-release.

It is a best effort with our limited resources.

In any case I've always thought that the TODO was developer-oriented
documentation, not something users would read. If there's a shortcoming
in a feature, it ought to be documented in the SGML manual.

It typically isn't, except for major issues, again due to lack of
resources.

I think you will have to search for a long time to find anybody who
actually uses it like that. I'm willing to bet that well over 95% of the
people who read the TODO only read it on the website. (potentially
excluding the actual patch-contributors, but those aren't included in your
argument anyway)

We can always remove it from the tarball and see if anyone complains.

I think that's a "reasonable default". If we do get complains, we'll figure
a way to get it back. It's not hard to get info out of a wiki.

//Magnus