Thread: Broken Link on Web site
From: http://www.PostgreSQL.org/docs/faq-english.html#2.1 "See also the ODBC chapter of the Programmer's Guide." To: http://www.PostgreSQL.org/users-lounge/docs/programmer/odbc.html
Thanks. I see the problem and have updated the FAQ. Vince, do we have a URL that goes directly to docs no matter the version? I used the URL: http://www.postgresql.org/devel-corner/docs/programmer/odbc.html Is that the best one that doesn't have a release number in the URL? > From: http://www.PostgreSQL.org/docs/faq-english.html#2.1 > "See also the ODBC chapter of the Programmer's Guide." > > To: http://www.PostgreSQL.org/users-lounge/docs/programmer/odbc.html > > ---------------------------(end of broadcast)--------------------------- > TIP 3: if posting/reading through Usenet, please send an appropriate > subscribe-nomail command to majordomo@postgresql.org so that your > message can get through to the mailing list cleanly > -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 853-3000 + If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania 19026
On Sun, 8 Apr 2001, Bruce Momjian wrote: > Thanks. I see the problem and have updated the FAQ. > > Vince, do we have a URL that goes directly to docs no matter the > version? I used the URL: > > http://www.postgresql.org/devel-corner/docs/programmer/odbc.html > > Is that the best one that doesn't have a release number in the URL? Here's the problem, I'm open to suggestions. If we use a non-version specific url, it has to point to something - probably development docs. Development docs change more often than stable docs, but with each new version we have a different set of stable docs. I'm in process of overhauling the ODBC stuff right now. Pages will be served up dynamically and I'm going to use it as a test bed for the interactive docs. It'll be at http://odbc.postgresql.org but don't look for anything other than a coming soon message there now. When it's up and running (shouldn't be long, Marc created the database today - the site was just conceived two days ago!) I'll be able to provide a solid link for it but I don't want to try and guess what I may use for it. Vince. -- ========================================================================== Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net 56K Nationwide Dialup from $16.00/mo at Pop4 Networking Online Campground Directory http://www.camping-usa.com Online Giftshop Superstore http://www.cloudninegifts.com ==========================================================================
OK, but for general pointing, I will point to development docs. > On Sun, 8 Apr 2001, Bruce Momjian wrote: > > > Thanks. I see the problem and have updated the FAQ. > > > > Vince, do we have a URL that goes directly to docs no matter the > > version? I used the URL: > > > > http://www.postgresql.org/devel-corner/docs/programmer/odbc.html > > > > Is that the best one that doesn't have a release number in the URL? > > Here's the problem, I'm open to suggestions. If we use a non-version > specific url, it has to point to something - probably development docs. > Development docs change more often than stable docs, but with each new > version we have a different set of stable docs. > > I'm in process of overhauling the ODBC stuff right now. Pages will be > served up dynamically and I'm going to use it as a test bed for the > interactive docs. It'll be at http://odbc.postgresql.org but don't look > for anything other than a coming soon message there now. When it's up > and running (shouldn't be long, Marc created the database today - the > site was just conceived two days ago!) I'll be able to provide a solid > link for it but I don't want to try and guess what I may use for it. > > Vince. > -- > ========================================================================== > Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net > 56K Nationwide Dialup from $16.00/mo at Pop4 Networking > Online Campground Directory http://www.camping-usa.com > Online Giftshop Superstore http://www.cloudninegifts.com > ========================================================================== > > > > -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 853-3000 + If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania 19026
> On Sun, 8 Apr 2001, Bruce Momjian wrote: > > > > > OK, but for general pointing, I will point to development docs. > > What I was trying to point out is the docs will change before the > actual sources do. Then folks waste time trying to do something > that's not even in the software they're running. If you don't > point at something stable and released, don't point at anything > unless you're putting your own email address on it. Those that > maintain it don't need to try and figure out why something doesn't > work if it's not even implemented yet. We HAVE been there before > and it wasn't fun - it tends to piss people off. OK, then I am asking for a symlink called 'current' or something that can be used in a URL. I can't hard-code in the version number in the URL. -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 853-3000 + If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania 19026
On Sun, 8 Apr 2001, Bruce Momjian wrote: > > OK, but for general pointing, I will point to development docs. What I was trying to point out is the docs will change before the actual sources do. Then folks waste time trying to do something that's not even in the software they're running. If you don't point at something stable and released, don't point at anything unless you're putting your own email address on it. Those that maintain it don't need to try and figure out why something doesn't work if it's not even implemented yet. We HAVE been there before and it wasn't fun - it tends to piss people off. Vince. > > > On Sun, 8 Apr 2001, Bruce Momjian wrote: > > > > > Thanks. I see the problem and have updated the FAQ. > > > > > > Vince, do we have a URL that goes directly to docs no matter the > > > version? I used the URL: > > > > > > http://www.postgresql.org/devel-corner/docs/programmer/odbc.html > > > > > > Is that the best one that doesn't have a release number in the URL? > > > > Here's the problem, I'm open to suggestions. If we use a non-version > > specific url, it has to point to something - probably development docs. > > Development docs change more often than stable docs, but with each new > > version we have a different set of stable docs. > > > > I'm in process of overhauling the ODBC stuff right now. Pages will be > > served up dynamically and I'm going to use it as a test bed for the > > interactive docs. It'll be at http://odbc.postgresql.org but don't look > > for anything other than a coming soon message there now. When it's up > > and running (shouldn't be long, Marc created the database today - the > > site was just conceived two days ago!) I'll be able to provide a solid > > link for it but I don't want to try and guess what I may use for it. > > > > Vince. > > -- > > ========================================================================== > > Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net > > 56K Nationwide Dialup from $16.00/mo at Pop4 Networking > > Online Campground Directory http://www.camping-usa.com > > Online Giftshop Superstore http://www.cloudninegifts.com > > ========================================================================== > > > > > > > > > > > -- ========================================================================== Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net 56K Nationwide Dialup from $16.00/mo at Pop4 Networking Online Campground Directory http://www.camping-usa.com Online Giftshop Superstore http://www.cloudninegifts.com ==========================================================================
Bruce Momjian writes: > Thanks. I see the problem and have updated the FAQ. > > Vince, do we have a URL that goes directly to docs no matter the > version? I used the URL: > > http://www.postgresql.org/devel-corner/docs/programmer/odbc.html > > Is that the best one that doesn't have a release number in the URL? The version number should be in there. The feature might change in a future version and the FAQ is going to point the wrong place. -- Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
> Bruce Momjian writes: > > > Thanks. I see the problem and have updated the FAQ. > > > > Vince, do we have a URL that goes directly to docs no matter the > > version? I used the URL: > > > > http://www.postgresql.org/devel-corner/docs/programmer/odbc.html > > > > Is that the best one that doesn't have a release number in the URL? > > The version number should be in there. The feature might change in a > future version and the FAQ is going to point the wrong place. But I am pointing to the ODBC documentation from the FAQ. How can that change? I am not point to a feature. -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 853-3000 + If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania 19026
Bruce Momjian writes: > OK, but for general pointing, I will point to development docs. Not a good idea. The development docs are equally unstable as the development software. In fact I'm playing with the idea of putting "This documentation set is for unreleased, under development software. This documentation itself is under development. It might be inaccurate, incomplete, or disappear tomorrow." in red on each HTML page, so we stop getting complaints every time a file name changes. -- Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/