SPAM-LOW: Re: SPAM-LOW: RE: [OpenAFS] Documetation for asetkey
Fri, 08 Jul 2005 11:32:48 -0700
Ken Hornstein wrote:
> This illustrates _exactly_ my feelings about documentation formats.
> Basically, I don't give a shit about 90% of the worthless crap that
> these systems do (yeah, I'm going to be writing a WHOLE LOT of theorems
> in the Kerberos FAQ); what I want is a simple layout that looks
> [remainder of rant deleted]
1. My message was information and an offer of help. It wasn't even a
recommendation. If you don't want it, don't take it. You don't need to
unload a bunch of attitude on me.
2. The theorem example was just that, an example. Would you be less
annoyed if the roles were FAQ-specific stuff like 'question' and
'answer'? With a little work, the subset of DocBook you'd have to know
would be *tiny*, and the subset of LaTeX you'd have to know would be *zero*.
3. The lesson that logical markup is better than visual has only been
learned ten gazillion times. If you're happy with HTML markup, great.
But it's not like this is an open question.