Gerv wrote:
> Clover wrote:
> > If I begin with a FAQ of 10 questions, then it grows to 50, and then to
> > 100... so I split the FAQ into separate files. At the end of the
> > process, all questions in misc.html are moved to the appropriate file.
> > Now, does it make sense for me to keep the misc.html URI?
>
> You should never have a URI called "misc.html" in the first place. ;-)
Quite right. You should have a URI like /foo/bar/faq.html and enable
MultiViews so you can always refer to it as just /foo/bar/faq
Now, if your FAQ grows, you can split it up into
/foo/bar/faq/install.html
/foo/bar/faq/options.html
/foo/bar/faq/plugins.html
etc.
and then you make /foo/bar/faq/index.html the table
of contents. In good style, you refer to all of the above
without extensions, and drop "index.html" from your URLs
entirely. Thus, nothing breaks (the server will send back
/foo/bar/faq/index.html any time someone asks for /foo/bar/faq)
and everything is forwards-compatible.
Note that I didn't use numbers for the subsections. This
is because a) Names are more descriptive.
b) I can reorder things without breaking links.
See http://mozilla.org/README-style.html for other notes on URIs.
~fantasai
_______________________________________________
mozilla-documentation mailing list
[EMAIL PROTECTED]
http://mail.mozilla.org/listinfo/mozilla-documentation
