[DOCS] Users comments don't migrate to docs for new version?
I've just found (via google...) useful (for me) comments: http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html -- I mean users comments under primary contents of the page. These comments were written for 8.0, but are useful for the current versions too. What we have is the situation that reading docs for 8.2 people don't see these comments -- so this potentially useful information is lost. So, in this implementation the idea of comments for docs becomes weak in general. In some other OSS projects comments for docs are used intensively and hold a lot of useful information for many people. The good example here is PHP docs -- sometimes comments are much more useful and much more important then the main contents itself! I understand that comments migration and maintenance might be a hard task, because some comments may be really out-dated... Maybe simple notice like "this comment was created for pg 8.0 docs" would help. -- Best regards, Nikolay ---(end of broadcast)--- TIP 3: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faq
Re: [DOCS] [pgsql-www] Users comments don't migrate to docs for new version?
Nikolay Samokhvalov wrote: > I've just found (via google...) useful (for me) comments: > http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html > -- I mean users comments under primary contents of the page. > > These comments were written for 8.0, but are useful for the current > versions too. What we have is the situation that reading docs for 8.2 > people don't see these comments -- so this potentially useful > information is lost. So, in this implementation the idea of comments > for docs becomes weak in general. The thing to do in these cases is to move the useful info from the user comments into the main doc text. -- Alvaro Herrerahttp://www.advogato.org/person/alvherre "La victoria es para quien se atreve a estar solo" ---(end of broadcast)--- TIP 9: In versions below 8.0, the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
[DOCS] Probably mistake in Arrays docs & proposal for index
Hey guys,
thank you for providing this perfect docs! Let me give two comments on it.
1) I think there is a small mistake in the Arrays docs at
http://www.postgresql.org/docs/8.2/interactive/arrays.html
Or can anyone explain me:
SELECT array_dims(schedule) FROM sal_emp WHERE name = 'Carol';
array_dims
[1:2][1:1]
with the following content: {{breakfast,consulting},{meeting,lunch}}
IMHO this should be [1:2][1:2]
2) Is it possible to integrate an alphabet into the index site?
http://www.postgresql.org/docs/8.2/interactive/bookindex.html
I would appreciate a small line on the top of the site like "[A] [B] [C]
... [Z]" with links to each block beginning with the letter.
Thanks a lot.
All the best,
/Christian
---(end of broadcast)---
TIP 3: Have you checked our extensive FAQ?
http://www.postgresql.org/docs/faq
Re: [DOCS] [pgsql-www] Users comments don't migrate to docs for new version?
Alvaro Herrera wrote: > Nikolay Samokhvalov wrote: >> I've just found (via google...) useful (for me) comments: >> http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html >> -- I mean users comments under primary contents of the page. >> >> These comments were written for 8.0, but are useful for the current >> versions too. What we have is the situation that reading docs for 8.2 >> people don't see these comments -- so this potentially useful >> information is lost. So, in this implementation the idea of comments >> for docs becomes weak in general. > > The thing to do in these cases is to move the useful info from the user > comments into the main doc text. Yeah, that's the idea. Tom often goes through the comments and puts stuff into the docs. But I'm sure there are a *lot* of other people who could help with that as well - read comments, figure out of they make sense, and submit a docs patch for the next version! //Magnus ---(end of broadcast)--- TIP 5: don't forget to increase your free space map settings
Re: [DOCS] [pgsql-www] Users comments don't migrate to docs for new version?
Magnus Hagander wrote: > Alvaro Herrera wrote: > > Nikolay Samokhvalov wrote: > >> I've just found (via google...) useful (for me) comments: > >> http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html > >> -- I mean users comments under primary contents of the page. > >> > >> These comments were written for 8.0, but are useful for the current > >> versions too. What we have is the situation that reading docs for 8.2 > >> people don't see these comments -- so this potentially useful > >> information is lost. So, in this implementation the idea of comments > >> for docs becomes weak in general. > > > > The thing to do in these cases is to move the useful info from the user > > comments into the main doc text. > > Yeah, that's the idea. Tom often goes through the comments and puts > stuff into the docs. But I'm sure there are a *lot* of other people who > could help with that as well - read comments, figure out of they make > sense, and submit a docs patch for the next version! Other people!?!?!? What are you thinking -- why would _anyone_ spend any effort in this, if Tom can make all the work for us??? No one else needs to bother!!! Surely Tom is the only person on earth who knows how to write proper english anyway. -- Alvaro Herrerahttp://www.CommandPrompt.com/ PostgreSQL Replication, Consulting, Custom Development, 24x7 support ---(end of broadcast)--- TIP 3: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faq
