Re: /doc layout in ftp.debian.org [was: Documentation provided in the Woody CDs (should be fixed)]
On Tue, May 07, 2002 at 09:29:30PM +0200, Josip Rodin wrote:
> On Fri, May 03, 2002 at 02:34:17PM +0200, Javier Fernández-Sanguino Pe?a wrote:
> > ?Have you had time to take a look at auric.debian.org/home/jfs/doc ?
> We have in the meantime discussed a little bit on IRC about this, and Javi
> made some adjustments. It's generally an improvement over the current layout
> (or rather, the current patchwork).
> http://auric.debian.org/~jfs/ BTW.
> We agreed that there is one thing missing -- proper indices. Apache's
> DirectoryIndex feature only goes so far in user-friendliness :)
> He started making a script to autogenerate indices.
> Javier and myself disagreed on two points of the layout:
> * he put the language choice before the exact document choice.
> I.e. once you pick a section, you get to pick the language, and then
> the specific document. I think you should get to pick the section,
> the document and then the language.
Why should we restrict to only one naming convention?
We could use a pool-like scheme:
and use symbolic links to match whatever hierarchy we want, e.g.
When a document is not translated into xx, we could also include a link
to show that this document does exist, even if it is not available in
I assume that all docs are generated in all available formats, whereas
this is obviously wrong with languages.
> * he chose foo-twoletterlanguagecode.filetypeextension
> I would prefer foo.twoletterlanguagecode.filetypeextension
Agreed, I also prefer dots for the same reason.
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org