darcs

Issue 1574 HTML documentation URLs are unstable

Title HTML documentation URLs are unstable
Priority bug Status given-up
Milestone Resolved in
Superseder Nosy List darcs-devel, dmitry.kurochkin, kowey, twb
Assigned To
Topics Documentation

Created on 2009-08-27.15:14:33 by kowey, last changed 2017-07-31.00:03:41 by gh.

Messages
msg8537 (view) Author: kowey Date: 2009-08-27.15:14:29
We sometimes have a habit of pointing people to pieces of the user
documentation, say
http://www.darcs.net/manual/node7.html#SECTION00771000000000000000

The problem is that if the documentation changes, 'node7.html' takes on a
different meaning.

It would be nice if this were more stable somehow, if latex2html or whatever
tool we later decide to build the documentation could somehow be persuaded to
use something that's a little more stable like the section title in its URLs.

Marking waiting-for as I assume this will be subsumed by the RST-isation work.
msg12129 (view) Author: kowey Date: 2010-08-12.10:42:13
I'll soon push a patch resolving part of this issue (replacing 
node3.html with eg. Getting_started.html)

Also, I think it's likely that we resolve this before the RSTisation 
work is complete.

This ticket is now waiting for comments on latex2html user list
http://tug.org/pipermail/latex2html/2010-August/003715.html

If they do not respond by 2010-08-19 we should try the advice listed
History
Date User Action Args
2009-08-27 15:14:33koweycreate
2010-08-12 10:42:14koweysetmessages: + msg12129
2017-07-31 00:03:41ghsetstatus: waiting-for -> given-up