Thread: Broken Link on Web site

Broken Link on Web site

From
Duncan John Fyfe
Date:

Re: Broken Link on Web site

From
Bruce Momjian
Date:
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

Re: Broken Link on Web site

From
Vince Vielhaber
Date:
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
==========================================================================




Re: Broken Link on Web site

From
Bruce Momjian
Date:
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

Re: Broken Link on Web site

From
Bruce Momjian
Date:
> 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

Re: Broken Link on Web site

From
Vince Vielhaber
Date:
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
==========================================================================




Re: Broken Link on Web site

From
Peter Eisentraut
Date:
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/


Re: Broken Link on Web site

From
Bruce Momjian
Date:
> 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

Re: Broken Link on Web site

From
Peter Eisentraut
Date:
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/