[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: doc-base 0.4 and other issues

Am 16.04.98 schrieb apharris # burrito.onshore.com ...

Moin Adam!

APH> We have two major policy issues to solve immediately (although it is

Why? We#re talking about Debian 2.1 and not about hamm!

APH> documents explaining these two issues right now.  As the doc-base
APH> maintainer, I shall take it upon myself to formulate the document (a),
APH> unless anyone has a valid objection to that.  BTW I'm going to make it

You can not create a document, because we haven#t defined the standards.  
But if we have done it, it would be nice.

APH> a separate SGML document, fold it out of the doc-base (but include it,
APH> isn't SUBDOC wonderful?).

No, I would suggest docreg.

APH> With respect to the proposed document heirarchy, I agree with Manoj in
APH> that the document should be more of an index than a table of contents.
APH> Furthermore, as an index, we need to allow crosslinking, in other

Please stopp this discussion. Keep it simple and let us start with the  
structure itself.

APH> words, a single document id may appear in multiple locations along the
APH> index.  I personally feel unhappy with every proposed heirarchy:
APH> Christian's is too deep; Marco's is too arbitrary.  I am wondering who

Have you looked at 3th version? I#ve included some suggestions.

APH> (a.2) Do we need any additional fields?

Please send me comments to my docreg suggestion.

APH> (a.3) Should we reconsider the 'document-id' system (one docid per
APH> file, many formats)?  Wouldn't it make it easier for package
APH> maintainers to have a single file that could have multiple
APH> document-ids?  Would this be a bad idea?

No, it#s a good idea. I will not support a standard where you need a file  
for one document, and two files for two documents. That#s nonsense. I  
would suggest that the document ID line must be the first line of a  
document. So you can have several IDs in one file:

  Doc: 1
  File: ...

  Doc: 2
  File: ....

Like <item></item> in .dhelp.

APH> (a.4) What file location is going to work given, say, a shared,
APH> NFS-mounted /usr?

I don#t understand that. Could you explain it please?

cu, Marco

Uni: Budde@tu-harburg.de           Fido: 2:240/5202.15
Mailbox: mbudde@hqsys.antar.com    http://www.tu-harburg.de/~semb2204/

To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

Reply to: