Broken Link on Web site

Started by Duncan John Fyfeabout 25 years ago9 messagesdocs
Jump to latest
#1Duncan John Fyfe
duncan@little-wonder.freeserve.co.uk
#2Bruce Momjian
bruce@momjian.us
In reply to: Duncan John Fyfe (#1)
Re: Broken Link on Web site

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
#3Bruce Momjian
bruce@momjian.us
In reply to: Bruce Momjian (#2)
Re: Broken Link on Web site

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
#4Vince Vielhaber
vev@michvhf.com
In reply to: Bruce Momjian (#2)
Re: Broken Link on Web site

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
==========================================================================

#5Bruce Momjian
bruce@momjian.us
In reply to: Vince Vielhaber (#4)
Re: Broken Link on Web site

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
#6Vince Vielhaber
vev@michvhf.com
In reply to: Bruce Momjian (#3)
Re: Broken Link on Web site

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
==========================================================================

#7Peter Eisentraut
peter_e@gmx.net
In reply to: Bruce Momjian (#2)
Re: Broken Link on Web site

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/

#8Peter Eisentraut
peter_e@gmx.net
In reply to: Bruce Momjian (#3)
Re: Broken Link on Web site

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/

#9Bruce Momjian
bruce@momjian.us
In reply to: Peter Eisentraut (#7)
Re: Broken Link on Web site

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