Re: About.html - needs your update!

[Aaron Turner <aturner@linuxkb.org>]

[I'm cc'ing this to the list becuase I think Spencer asks some good
questions]


On Wed, 27 Oct 1999, Spencer Portee wrote:

> moo> please about it :-) update the page.  If I don't see activity from you in
> moo> the next 3-5 days or so, I'll assume you are no longer interested and lock
> moo> your accounts.
> 
> I don't understand what needs to be done.  ALl I can tell is that
> documentation needs to be written for the API.
> 

Open Source software with documentation?  You're joking right? :-)

I know everyone would like more help writing things with the Objects that
Jason has written- I've been hounding Jason to get it done.  He promises
me only another day or two (right Jason!).

In the meantime, ask questions!  Part of the problem with documentation is
that it's hard to know what people need to have explained to them and what
part is self-explanatory.  What part of the site were you interested in
working on?  Let Jason know and he'll be more than happy to answer your
questions.  If you don't know what you're interested in working on (or
what needs to be done) then ask.  

I think everyone is expecting Jason and I to hold their hand and tell them
what to do and how to do it.  Jason and I don't have the time or interest
in doing that.  We're runing this project more like the Linux kernel where
developers are self-starters and run with things and ask questions when
they're stuck.  The information that Jason went over in the IRC chat last
time (if you missed it, you can read the log at the URL at the end of this
email) should be enough to get you started.  I'll be the first to admit
that it's not complete or enough to make you completely comfortable.  But
betwen the logs and the comments in functions.php3 you should have enough
to do *something*.  Worst case you could look at functions.php3 /
render.php3 and read what's going on there- *everything* you need to know
is there.

Also, I didn't mean to say you had to be coding within the next 3-5 days.
Just that I want people to update about.html in the next 3-5 days.
Everyone should have *NO* problem in doing that. :-)  I realize that it
may take a week just to figure out how to use the objects in your code
effectively.  I'm not asking for you to do a lot, just something.

http://devel.linuxkb.org/irc/19990928.html
and
http://devel.linuxkb.org/irc/19991027.html


--
Aaron Turner, Core Developer       http://vodka.linuxkb.org/~aturner/
Linux Knowledge Base Organization  http://linuxkb.org/
Because world domination requires quality open documentation.