[as-devel] Re: AS documentation maintenance
irb (irb@viopac.com)
Mon, 19 Mar 2001 15:58:37 -0800
* Sasha Vasko/OSCA/Courts/Judicial (sashav@sprintmail.com) [010319 07:28]:
>
> > Sasha, I don't know if you've been following this, but I seem to have
>
> Yeah, I don't do much e-mail reading over weekends :)
...which is probably a good thing. *grin*
> > volunteered my services as a Documentation Pedant. There I was reading
> > the list archives on tigr.net and thinking maybe I should subscribe and
> > start answering questions. Well, seems like heading up documentation for
> > AS would be a great way to do that. *grin*
>
> Yes it will be.
>
> Firstly few things you need to know about documentation :
> AS documentation has 2 parts - FAQ and man pages. At the time FAQ
> maintainer is Charlie Schimdt (aka ishamael), he's also as.themes.org
> maintainer. man pages used to be maintained by David Mihm, and as a
> result of his negative stance towards 1.9 series of AS he's never
> updated them after 1.8 release. I would really be happy to see
> someone enthusiastic to pick it up.
I'd love to. I don't know the details (or much else) about what happened
with Dave, so I'll avoid saying anything about that; I will say that
I've always been enthusiastic about AS- ever since 1.0.
As to what I plan to do, I'd like to get started with 1.8 first, working
on the READMEs and default config files (the comments at least); that
will serve the dual purpose of getting me used to working on the project
as well as the rest of the development team getting used to working with
me *grin*
I'll need to do some reading and playing around with 1.9 before I tackle
that as well.
[snip - I'll keep that as a reference. thanks]
> If you decide that you like what you see and produce any usefull results -
> send them to me as a patch for review and if it looks good we'll add commit
> access to CVS server for you.
I'll do that. Do you prefer one single patch or individual ones per
file changed? Should I send them to you directly or to the devel list (I've
just subscribed to the latter now)?
Which brings up another question: is there a document somewhere that
details the AS contribution process and if not, would you like there to
be?
> > I am to understand, then, that you need a new webmaster and webspace? If
> > you don't have someone in mind, I might be able to help out there too. I
> > don't want to come in with guns blazing or anything, but I do have a
> > good deal of html experience and I am a sysadmin. Anyway, one thing at a
> > time, eh?
>
> Well, we are still in the state of uncertainity as to what will Dave Mihm,
> do so it is a bit early to talk about new maintainers for fao and wao.
Certainly. I don't want to step on anyone's feet here, I just don't know
(and it may be none of my business) what's going on with regards to
Dave; I didn't know /anything/ was going on when I volunteered.
Two sidenotes: First off, I need to finish painting my apartment so I
probably won't start in for a few days. Also, in case you're wondering,
my name is Ian Bennett. Hi.
> Sasha Vasko
/i.