[OpenAFS-Doc] RE: [OpenAFS] OpenAFS Web page...

[ted creedon]

Bil,

If you want editing and proofing, I'm willing to try to fit some of that
kind of work in (I've offered before). I don't know about updating--it's not
like I know that much about afs, especially server side--but I've got
experience editing.

Sorry to ask a stupid question, is there a single central repository for the
docs regardless of format?

not yet except on my site

And is this a big enough issue to warrant a separate list?
FWIW, my experience has been that the frustrating thing about the
documentation I've been able to find so far is that it's very terse. I do
not mean that in a critical way, since I understand the shortness of time,
but that is a barrier to new adopters.

Do you have access to Win Adobe Professional? It's a great way to comment

on the docs in pdf format.

Do you have any experience with DocBook?

ted
--

________________________
bil hays
Network Manager
Computer Science, UNC CH

[ted creedon]

All good questions, with no immediate answers.

tgc:The book "Managing AFS" by Campbell is out of print and should really

be replaced by an "OpenAFS, Operation and Maintenance Manual".

Perhaps there are some other suggestions?

tgc:I'd rather see raw content produced over form. It won't be by the

developers since they're buried with work. TXT or html files are OK with me,
the conversion to Latex is simple.

So, I take it this a matter of text conversion?

tgc: Actually the publications are compiled from Latex source in a batch

process.

How do the docs get checked out of and back into CVS?

tgc: I can set a CVS site up if openafs doesn't.

Who gives the approval before new editions or formats are released to the
public?

tgc: Good question. Since the docs are in Latex/pdf/html format using a

collaborative review and comment system pretty much limits us to using
Adobe, unless pdf's are used with Chapter/Section/line numbers. This is
somewhat archaic but would suffice. The developers are the only people with
the knowledge to review...

Could someone interested in this get write access to an AFS directory on
openafs.org?

tgc: Jaltman??

Michael