[OpenAFS] How to volunteer?

chas williams - CONTRACTOR chas@cmf.nrl.navy.mil
Mon, 09 Apr 2007 10:33:57 -0400


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.


In message <Pine.GSO.4.61-042.0704072233110.1487@johnstown.andrew.cmu.edu>,Derr
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:
>
>> Hi,
>>
>> 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 
>> http://www.openafs.org/pipermail/openafs-info/2006-October/024061.html 
>> 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?
>>
>> Sincerely,
>> Jason
>> _______________________________________________
>> OpenAFS-info mailing list
>> OpenAFS-info@openafs.org
>> https://lists.openafs.org/mailman/listinfo/openafs-info
>>
>_______________________________________________
>OpenAFS-info mailing list
>OpenAFS-info@openafs.org
>https://lists.openafs.org/mailman/listinfo/openafs-info
>