[OpenAFS] How to volunteer?
Mon, 9 Apr 2007 07:39:33 -0700
Indexing, table of contents, and appendicies, and hyperlinks to specific
page numbers. How about the footnotes and the different fonts used? Is all
From: firstname.lastname@example.org [mailto:email@example.com]
On Behalf Of chas williams - CONTRACTOR
Sent: Monday, April 09, 2007 7:34 AM
To: Derrick J Brashear
Cc: Jason Edgecombe; OpenAFS-Info
Subject: Re: [OpenAFS] How to volunteer?
the ibm html documentation has been converted to xml (the preferred
format). its in the cvs repository. its a straight conversion with
little editing so the documentation still says 'AFS 3.6'. i didnt
proof every single page so there might be a few errors (mostly in
tables, and command syntaxes trees).
the reference guide is now built by converting the existing pod
documention to xml. however, the indexing information was lost during
the initial pod conversion. someone we will need to try to get that back.
the quick start unix guide would probably be the easiest to update.
it needs the updated instructions from README shipped with the current
release of openafs integrated.
ick J Brashear writes:
>Russ Allbery has been coordinating documentation work. Please talk to him
>before you start on something if you'd like to avoid duplicating effort.
>As to unit tests, that's an open question. We should probably start a
>discussion on openafs-devel about it
>On Sat, 7 Apr 2007, Jason Edgecombe wrote:
>> There is nothing on the web site about how to
>> volunteer for the openafs project.
>> I sincerely think that OpenAfs rocks, but I worry
>> about the vitality or the perceived vitality of
>> the community. I think that the best way for me to
>> fight that is to help make OpenAfs better.
>> I would like to help with documentation and
>> writing of automated tests.
>> How can I contribute to the documentation? Where
>> is the source? What is the preferred format?
>> Russ said in
>> that the documentation needs to be converted to
>> Pod/docbook. How can I help?
>> I would also like to start writing automated tests
>> to help. I prefer Perl or Ruby. My C/C++ is rusty.
>> How should I go about doing that?
>> I might possibly tackle a setup wizard or a vmware
>> appliance after I work on the docs. Comments?
>> OpenAFS-info mailing list
>OpenAFS-info mailing list
OpenAFS-info mailing list