Robert wrote:
>I will do what I can! I'm not an expert in CVS, but I have used it. Most
>of what I've done has been through a UI (JCvs for example), although I'm
>not afraid of a command line :-)
>
>The areas I'm not familiar with are branches, tags, and those kinds of
>things. I can certainly checkout, update, etc. though.
>
>I've wanted to dig into the xdocs stuff for a while so this would be a
>good start for me. I'll grab the latest and start from there. Any
>particular area you want targeted? Avalon framework, Excalibur, etc?
>Stephen (prefer Steve?) mentioned the .../notes/comments stuff, so I
>could easily start there.
>
Here are initial comments on the Project Home Page
http://jakarta.apache.org/avalon/index.html
"What is it?" - this needs to be much more specific - it should
present something like a bulleted into to the subprojects - should
not say anything about what it does not do - should not be phrased
in negatives.
"Project Goals" - needs to be presented in a more aggressive fashion,
e.g. The Avalon goal is to delivering software engineering solutions.
"Sub-Projects" - this section needs to more concrete content - e.g.
the framework description should say that it is a set of interfaces
and implementations supporting the creation and managemnt of
components - excalibur should be rewritten to be better describe
that fact that there is a lot of "above-the-framework" and IOC based
mini-projects covering .... LogKit should updated to say that it an
IOC based logging framework (as opposed to the logging framework used
by Avalon). Cornerstone should be included in Appplications and
Applications could be expended with a table with very short
descriptions of each project.
Cheers, Steve.
>
>Another question... how would you all like to 'view' this? Just send
>patches or whatever, or would you like me to generate the docs/site on
>my local machine and let you all preview it before sending it in? I have
>a cable modem and my IP hasn't changed in over 6 months so I certainly
>don't mind doing so. I use my machine for demos for my company all the
>time anyway so it is always up. Just a thought.
>
>
I have no problem receiving directly small or large attachements.
Response time on answers my be sporadic as I will be in and out of the
office a lot over the next 7-10 days.
Cheers, Steve.
>- Robert
>
>-----Original Message-----
>From: Leo Simons [mailto:[EMAIL PROTECTED]]
>Sent: Wednesday, May 15, 2002 1:49 PM
>To: Avalon Developers List
>Subject: RE: [Newbie question] Confused (with correction)
>
>Robert,
>
>that would be great! We really need a few extra hands working on the
>docs...
>
>You know CVS? You'll need to, really.
>
>The XML format we use is defined in DTDs in
>
>jakarta-avalon/src/xdocs/dtd
>
>where the relevant one is document-v10.dtd. It is a lot easier to just
>look at the xml files in
>
>jakarta-avalon/src/xdocs
>
>though, and do your work by copy-pasting at first.
>
>To create a new page, you also need to add an entry to the book.xml
>file, which defines the menu on the left. Should be easy to figure out
>from the example alone (there's a dtd for it too, if you want one).
>
>I'm working on reorganising text we currently have so that the
>information in there is easier to find (I'm done for framework and
>phoenix). If you supply patches actually improving that information, we
>all will be very happy =)
>
>Oh, address for patches is this list.
>
>The info is in the heads of the committers here, as well as scattered
>across the website and in the mailing list archive. Getting it out of
>there and into something useful is the hard part ;)
>
>The easiest way to be productive would be to figure out what information
>you personally miss on the website, dig into all available sources to
>find that information, and if it is not there or too difficult to find,
>to ask on the mailing list.
>
>For starters, it'd be nice if this little bit of info went online for
>the next time someone has the same thought :)
>
>Lastly, don't worry too much about stepping on someone's toes as far as
>the docs are concerned...we've got though skin (wrt writing skills, at
>least)
>
>- Leo
>
>On Wed, 2002-05-15 at 19:39, Robert wrote:
>
>
>>I wouldn't mind helping out here if I can(?). If I had the right info
>>
>>
>to
>
>
>>add and the format, I would be happy to help with the docs/website
>>unless someone else has already volunteered with that. Maybe I can
>>
>>
>bring
>
>
>>that use perspective on it...
>>
>>Just a thought
>>
>>- Robert
>>
>>
>
>
>
>--
>To unsubscribe, e-mail:
><mailto:[EMAIL PROTECTED]>
>For additional commands, e-mail:
><mailto:[EMAIL PROTECTED]>
>
>
>
>--
>To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
>For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
>
>
>
--
Stephen J. McConnell
OSM SARL
digital products for a global economy
mailto:[EMAIL PROTECTED]
http://www.osm.net
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
