pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
Changing the HTML file extension
8+ messages / 5 participants
[nested] [flat]

* Changing the HTML file extension
@ 2001-02-11 22:34 Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 22:48 ` Re: Changing the HTML file extension Bruce Momjian <pgman@candle.pha.pa.us>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
  0 siblings, 2 replies; 8+ messages in thread

From: Peter Eisentraut @ 2001-02-11 22:34 UTC (permalink / raw)
  To: pgsql-docs

Since I'm writing a custom stylesheet for the docs anyway, we could change
the extension of the HTML files from .htm to .html.  This will probably
break a lot of bookmarks, so I thought I'd ask.  OTOH, "deep" bookmarks
into the current docs may become obsolete for a variety of other reasons
anyway.

-- 
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/




^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
@ 2001-02-11 22:48 ` Bruce Momjian <pgman@candle.pha.pa.us>
  1 sibling, 0 replies; 8+ messages in thread

From: Bruce Momjian @ 2001-02-11 22:48 UTC (permalink / raw)
  To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs

Agreed.   *.htm is an old DOS-ism.

> Since I'm writing a custom stylesheet for the docs anyway, we could change
> the extension of the HTML files from .htm to .html.  This will probably
> break a lot of bookmarks, so I thought I'd ask.  OTOH, "deep" bookmarks
> into the current docs may become obsolete for a variety of other reasons
> anyway.
> 
> -- 
> Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/
> 
> 


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



^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
@ 2001-02-11 23:43 ` Vince Vielhaber <vev@michvhf.com>
  2001-02-12 00:06   ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
  2001-02-12 00:10   ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
  1 sibling, 2 replies; 8+ messages in thread

From: Vince Vielhaber @ 2001-02-11 23:43 UTC (permalink / raw)
  To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs

On Sun, 11 Feb 2001, Peter Eisentraut wrote:

> Since I'm writing a custom stylesheet for the docs anyway, we could change
> the extension of the HTML files from .htm to .html.  This will probably
> break a lot of bookmarks, so I thought I'd ask.  OTOH, "deep" bookmarks
> into the current docs may become obsolete for a variety of other reasons
> anyway.

Any name changes will affect:

1) FAQ pointers into the docs
2) Web page pointers into the docs
3) Bookmarks
4) Search engine tables

If this is done, the search tables will need to be flushed of old links.
Marc was trying to do it the other day but I don't know how successful
he was on clearing out /docs.  /devel-corner/docs will also have to be
done if he was successful.  From a conversation I had with Peter yesterday
I agree that it's probably a bad idea to even allow /devel-corner/docs
into the search engine's tables - besides the fact that they change alot
between versions and old ones don't seem to flush.

FAQ pointers should also never point inside development docs (or any
docs for all that matter if they stand a chance of changing at all).

Bookmarks.  Many users will bookmark parts of the docs.  While it's not
a good idea to bookmark development docs it's still done.  I don't think
there's alot we can do about that.

Web pages that point inside the docs.  We have some web pages that have
been done and are maintained by folks other than me.  Those folks will
need to make sure none of theirs point inside the devel docs.  The home
page points to the devel docs index - I can repoint things when necessary
but that probably won't happen till sometime mid next week.

Vince.
-- 
==========================================================================
Vince Vielhaber -- KA8CSH    email: vev@michvhf.com    http://www.pop4.net
 128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
        Online Campground Directory    http://www.camping-usa.com
       Online Giftshop Superstore    http://www.cloudninegifts.com
==========================================================================






^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 00:06   ` The Hermit Hacker <scrappy@hub.org>
  1 sibling, 0 replies; 8+ messages in thread

From: The Hermit Hacker @ 2001-02-12 00:06 UTC (permalink / raw)
  To: Vince Vielhaber <vev@michvhf.com>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs


All good points ... is there a *valid* reason why we'd switch from .htm to
.html?  Like is .htm breaking anything?  if not, it should be left as is
...


On Sun, 11 Feb 2001, Vince Vielhaber wrote:

> On Sun, 11 Feb 2001, Peter Eisentraut wrote:
>
> > Since I'm writing a custom stylesheet for the docs anyway, we could change
> > the extension of the HTML files from .htm to .html.  This will probably
> > break a lot of bookmarks, so I thought I'd ask.  OTOH, "deep" bookmarks
> > into the current docs may become obsolete for a variety of other reasons
> > anyway.
>
> Any name changes will affect:
>
> 1) FAQ pointers into the docs
> 2) Web page pointers into the docs
> 3) Bookmarks
> 4) Search engine tables
>
> If this is done, the search tables will need to be flushed of old links.
> Marc was trying to do it the other day but I don't know how successful
> he was on clearing out /docs.  /devel-corner/docs will also have to be
> done if he was successful.  From a conversation I had with Peter yesterday
> I agree that it's probably a bad idea to even allow /devel-corner/docs
> into the search engine's tables - besides the fact that they change alot
> between versions and old ones don't seem to flush.
>
> FAQ pointers should also never point inside development docs (or any
> docs for all that matter if they stand a chance of changing at all).
>
> Bookmarks.  Many users will bookmark parts of the docs.  While it's not
> a good idea to bookmark development docs it's still done.  I don't think
> there's alot we can do about that.
>
> Web pages that point inside the docs.  We have some web pages that have
> been done and are maintained by folks other than me.  Those folks will
> need to make sure none of theirs point inside the devel docs.  The home
> page points to the devel docs index - I can repoint things when necessary
> but that probably won't happen till sometime mid next week.
>
> Vince.
> --
> ==========================================================================
> Vince Vielhaber -- KA8CSH    email: vev@michvhf.com    http://www.pop4.net
>  128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
>         Online Campground Directory    http://www.camping-usa.com
>        Online Giftshop Superstore    http://www.cloudninegifts.com
> ==========================================================================
>
>
>
>

Marc G. Fournier                   ICQ#7615664               IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org           secondary: scrappy@{freebsd|postgresql}.org




^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 00:10   ` Tom Lane <tgl@sss.pgh.pa.us>
  2001-02-12 00:21     ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
  2001-02-12 00:33     ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
  1 sibling, 2 replies; 8+ messages in thread

From: Tom Lane @ 2001-02-12 00:10 UTC (permalink / raw)
  To: Vince Vielhaber <vev@michvhf.com>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs

Vince Vielhaber <vev@michvhf.com> writes:
> [ a long list of places that might have links to documentation pages ]

I think this discussion is largely pointless.  We have already made a
substantial number of changes in the filenames of various doc pages
since 7.0 (for instance, there aren't numbers in most of 'em anymore),
and I didn't hear anyone objecting.  Asking that bookmarks not break is
a little late at this point.

I'm for changing to .html, FWIW.

			regards, tom lane



^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
  2001-02-12 00:10   ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
@ 2001-02-12 00:21     ` Vince Vielhaber <vev@michvhf.com>
  2001-02-12 01:01       ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
  1 sibling, 1 reply; 8+ messages in thread

From: Vince Vielhaber @ 2001-02-12 00:21 UTC (permalink / raw)
  To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs

On Sun, 11 Feb 2001, Tom Lane wrote:

> Vince Vielhaber <vev@michvhf.com> writes:
> > [ a long list of places that might have links to documentation pages ]
>
> I think this discussion is largely pointless.  We have already made a
> substantial number of changes in the filenames of various doc pages
> since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> and I didn't hear anyone objecting.  Asking that bookmarks not break is
> a little late at this point.

I agreed about the bookmarks but as to the files changing and noone
objecting, I wish I knew you were responsible BEFORE I answered all
the messages about missing links in the FAQs that pointed to number
type filenames, I could have simply forwarded them to you and saved
alot of time.  I think I will change the 404 page tho to tell folks
to send a note to the docs list if it's doc related.  If something
breaks everyone will know about it alot sooner.

Vince.
-- 
==========================================================================
Vince Vielhaber -- KA8CSH    email: vev@michvhf.com    http://www.pop4.net
 128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
        Online Campground Directory    http://www.camping-usa.com
       Online Giftshop Superstore    http://www.cloudninegifts.com
==========================================================================






^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
  2001-02-12 00:10   ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
  2001-02-12 00:21     ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 01:01       ` The Hermit Hacker <scrappy@hub.org>
  0 siblings, 0 replies; 8+ messages in thread

From: The Hermit Hacker @ 2001-02-12 01:01 UTC (permalink / raw)
  To: Vince Vielhaber <vev@michvhf.com>; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; Peter Eisentraut <peter_e@gmx.net>; pgsql-docs

On Sun, 11 Feb 2001, Vince Vielhaber wrote:

> On Sun, 11 Feb 2001, Tom Lane wrote:
>
> > Vince Vielhaber <vev@michvhf.com> writes:
> > > [ a long list of places that might have links to documentation pages ]
> >
> > I think this discussion is largely pointless.  We have already made a
> > substantial number of changes in the filenames of various doc pages
> > since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> > and I didn't hear anyone objecting.  Asking that bookmarks not break is
> > a little late at this point.
>
> I agreed about the bookmarks but as to the files changing and noone
> objecting, I wish I knew you were responsible BEFORE I answered all
> the messages about missing links in the FAQs that pointed to number
> type filenames, I could have simply forwarded them to you and saved
> alot of time.  I think I will change the 404 page tho to tell folks
> to send a note to the docs list if it's doc related.  If something
> breaks everyone will know about it alot sooner.

sounds perfectly reasonable to me ... you are on that list too, right?  so
it would hit aall pertinent ppl ...





^ permalink  raw  reply  [nested|flat] 8+ messages in thread

* Re: Changing the HTML file extension
  2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
  2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
  2001-02-12 00:10   ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
@ 2001-02-12 00:33     ` The Hermit Hacker <scrappy@hub.org>
  1 sibling, 0 replies; 8+ messages in thread

From: The Hermit Hacker @ 2001-02-12 00:33 UTC (permalink / raw)
  To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Vince Vielhaber <vev@michvhf.com>; Peter Eisentraut <peter_e@gmx.net>; pgsql-docs

On Sun, 11 Feb 2001, Tom Lane wrote:

> Vince Vielhaber <vev@michvhf.com> writes:
> > [ a long list of places that might have links to documentation pages ]
>
> I think this discussion is largely pointless.  We have already made a
> substantial number of changes in the filenames of various doc pages
> since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> and I didn't hear anyone objecting.  Asking that bookmarks not break is
> a little late at this point.

Damn, I hate it when someone comes up with even better points *sigh*

I'm for changing also ...




^ permalink  raw  reply  [nested|flat] 8+ messages in thread


end of thread, other threads:[~2001-02-12 01:01 UTC | newest]

Thread overview: 8+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 22:48 ` Bruce Momjian <pgman@candle.pha.pa.us>
2001-02-11 23:43 ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:06   ` The Hermit Hacker <scrappy@hub.org>
2001-02-12 00:10   ` Tom Lane <tgl@sss.pgh.pa.us>
2001-02-12 00:21     ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 01:01       ` The Hermit Hacker <scrappy@hub.org>
2001-02-12 00:33     ` The Hermit Hacker <scrappy@hub.org>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox