On Mon, 2006-10-16 at 11:25, KP Kirchdoerfer wrote: > Hello Mike; > > are you still around?
KP, Yes. > I'm getting more and more annoyed by the fact that I'm waiting for more than > a > year to see the documentation pages in a readable state - see > http://leaf.sourceforge.net/doc/ Understood. > It's really hard to design and write doc's (esp. if one's native language > isn't english) - and a lot of people tried hard to provide guides and howto's > to alleviate the usage of LEAF appliances and to teach new developers about > the LEAF specifics. > But as the documentation page presents itself to the users today, all of the > work is nearly useless. Even die-hard LEAF users do have difficulties to find > the chapters they are interested in. > And it is discouraging to work on new docs, if they are buried in a > conglomerate of titles, subtitles and subsubtitles. I've posted numerous times mentioning the DocBook XSL guide. The last time was on Jul 04, 2006. DocBook XSL: The Complete Guide http://www.sagehill.net/docbookxsl/ All the information on xsl customization of our docbook content presentation is in that guide. I haven't had time to generate a customization layer for us. > Another issue is, that still the first guide is a Bering guide. This IMHO a > bad design decision - the latest Bering version is more than three years old. > Who expects a user to wade through all that stuff to find (newly written) > docs for Bering-uClibc or any other recent distribution? The way it is, it > looks for a mere user, that there is a project, which does have some new > releases, but a dead documentation. Which is not true!!! We are working > constantly to improve doc's and provide new documentation - but it's lost! That is easy to fix. Just modify doc/leaf-doc-set.xml in cvs. It's just a set of xincludes, and you have global write access in our cvs repository. http://leaf.cvs.sourceforge.net/leaf/doc/leaf-doc-set.xml?revision=1.6&view=markup > Mike, I've asked you at least twice in the last year privately to solve this > issues - to no avail. Cause the situation is getting worth with our upcoming > 3.0 version, where new docs should be visible, I'm going to ask in public - > and yes I'm embarassed. No need to be embarrassed. Public discussion is what distributed open source projects are all about. > Less by the fact that nothing had happend - but if you feel LEAF isn't your > project any longer, if you still have difficulties to work due to your > accident - why didn't you just asked for help for page maintenance? I'll reply to this privately in a few days, with an admin group message. > The way it is, is bad and it can just become better. Anyone could have fixed/addressed your issues. I'm not the only capable person in this project. -- Mike Noyes <mhnoyes at users.sourceforge.net> http://sourceforge.net/users/mhnoyes/ SF.net Projects: leaf, phpwebsite, phpwebsite-comm, sitedocs ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ leaf-devel mailing list leaf-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/leaf-devel
