Re: mavenized oscore, propertyset & osuser

[email protected] wrote on 19/12/2003 
02:39:47 AM:

> I've ranted and raved elsewhere about maven far too much as it is, 
> google for 'maven bileblog' for more info.

Like I hadn't noticed.

> Regarding docs, Maven doesn't give you any extra docs, it gives you the 
> illusion of documentation which in any ways is more dangerous. 

Heck, I'd take an illusion over the fantastic tutorial @ 
http://www.opensymphony.com/osuser/ anyday. The actual user documentation 
on OsUser is almost nil.
Who could give a rats ass about pluggable providers if they can't work out 
how to use the thing in the first place. It hasn't had a 1.0 release and 
someone has already 'started refactoring it mercilessly'.  Sounds like 
Maven all over again.

> Ultimately, someone interesting in the usage of osuser couldn't give a 
> crap about how well the test coverage is, or any of the millions of 
> other generic project pages that maven craps out.

Who cares what Maven pumps out? The lack of usable documentation on OsUser 
almost stopped me using it for a project recently. Where's the freaking 
download link for &deity;'s sake? And the web site @ 
https://osuser.dev.java.net/ is a joke. I sent a patch in for it months 
ago to point to the os site, but that was soundly ignored.

> The only way for docs to happen is for someone to do them the old 
> fashioned way, by going through the library and documenting how things 
> work, and how to best make use of it all.
Well duh.
--
dIon Gillard, Multitask Consulting
Blog:      http://blogs.codehaus.org/people/dion/






-------------------------------------------------------
This SF.net email is sponsored by: IBM Linux Tutorials.
Become an expert in LINUX or just sharpen your skills.  Sign up for IBM's
Free Linux Tutorials.  Learn everything from the bash shell to sys admin.
Click now! http://ads.osdn.com/?ad_id=1278&alloc_id=3371&op=click