Re: Re^2: directory structure - 2.
On Thu, Apr 16, 1998 at 08:05:00PM +0100, Marco Budde wrote:
> Moin Christian!
>
> CS> This sounds like a great idea! If noone else objects, please start
>
> ? I#ve posted already such a list.
But it seems you don't have much supporters with it...
> CS> maintaining the list! If the list has evolved and is ready, it should
> CS> become part of the doc-base documentation.
>
> ? No it should be part of the Policy or a free standard. This structure
> will not only used by doc-base.
>
> CS> I've included a first proposal of myself below. Note, that this is just my
> CS> very personal opinion--feel free to change this if you don't like it.
>
> Please remove the documents itself from the structure. They#re not
> interesting for our discussion.
? This seems to disqualify you. The documents have to fit in the structure at
least, haven't they?
> CS> 1. Most people seem agree that documents should to be registered in
> CS> several sections at once. This should be considered when setting up the
> CS> structure.
>
> Most people? Let#s stop this discussion. At first we should talk about the
> structure and the file format. The use of the system should be discussed
> in debian-devel.
People that expressed the desire or agreement: Manoj, Christian, Adam and
me. People that didn't: you. Am I missing someone?
> CS> 2. For now, I think we should use the section titles in our list (like
>
> I disagree. That#s confusing.
>
> CS> make it much easier for us to recognize the correct section for a
>
> We will not discuss the section for a document. This should be done by the
> maintainers of these documents.
I heartly disagree. There should be clear ideas about the content of a
section. It seems that you don't have a clue about the meaning of a structure
at all.
> CS> document. If we've finally agreed on the section titles, we can look for
> CS> the correct short terms later.
>
> I prefer the other way.
I'm not sure why.
> CS> 5. We should keep in mind that the structure should make it as simple as
> CS> possible for the users to find the documentation their looking for.=20
>
> That#s it.
Nice that you see that.
> CS> 6. AFAIR, dhelp displays only `used' sections (i.e., sections which
> CS> contain documents). I think, in general, it would be better if the online
> CS> systems always display all available sections, even if these are empty, so
> CS> that the user knows where to look for documentation next time.
>
> I don#t understand that. We should a system display 30 directories that
> don#t include one document? And this is not interesting for the structure.
>
> CS> 7. I think it's useful to already include a few example documents in the
> CS> structure to get a better feeling about what will go into which section.
>
> I disagree.
You fail again. What do you want, Marco. From all your argumentation I can't
get a single hint that you want to make it easy for the user. Why do you
disagree? Do you have the user in mind? Have you hidden reasons, you don't
want to tell us? Has it to do with dhelp?
> CS> 8. We should keep in mind that the section titles will eventually be
> CS> translated into the user's native language. But for now, we should stick
> CS> to discuss the English titles.
>
> The titles are not interesting. We#re talking about the structure and the
> short names.
Nobody is talking about the short names? Do you want to present the user a
list of cryptic short names they already know from the ftp server, and that
are NOT GIVING A SINGLE CLUE where they should look for help?
Are you talking about the same thing as we do?
> CS> language. I think the only logical way to handle this situation, is to
> CS> store documents of all languages in a single structure, and let the user
> CS> choose the preferred language at document-level, like in this example:
> CS>
> CS> User's Manuals
> CS> Office applications
> CS> _StarOffice User's Manual_ (English version, German version)
>
> I disagree 100%.
You waste your time on disagreeing with examples, Marco.
It is time that real work is done.
Marcus
--
"Rhubarb is no Egyptian god." Debian GNU/Linux finger brinkmd@
Marcus Brinkmann http://www.debian.org master.debian.org
Marcus.Brinkmann@ruhr-uni-bochum.de for public PGP Key
http://homepage.ruhr-uni-bochum.de/Marcus.Brinkmann/ PGP Key ID 36E7CD09
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: