Hi Frank,

On Aug 9, 2007, at 9:43 PM, Frank Misa wrote:

Hi All,

I'm really disappointed by the lack of in depth XWiki developer tutorial.
XWiki has been around for a while -- and the only good material I can find is here:
http://www.xwiki.org/xwiki/bin/view/DevGuide/FAQTutorial
http://www.xwiki.org/xwiki/bin/view/DevGuide/CreatingPlugins

This is a great opportunity for you to set this right! :)

Once you understand it, could we count on you to improve the documentation on the xwiki.org wiki?

The above links are the level of tutorial I'm looking for -- but they don't go far/long enough....
I've followed the FAQTutorial steps and cannot get the example to work as described.

I've performed all steps as described -- without error/warning -- but when I try to create a new custom FAQ document -- my class properties (question & answer) are not being shown on the edit/creation page ?  It's just blank space with two rows of Cancel/Save-Continue/Save-View etc buttons.

* I'm using XWIKI: 1.1-milestone-3.3933
* On Windows XP with Apache Tomcat 5.5.12
* I'm using MySQL as the database - I think it's UTF8 - Server version: 5.0.13-rc-nt

1) When I'm querying the database -- the tables:
     xwikiproperties - is being populated -- but newly added entries seem to have negative values for XWO_ID column.
     xwikiobjects - is being populated -- but newly added entries seem to have negative values for XWO_ID column.
     xwikiclasses - is empty ? why ?

2) I would be very grateful to a link to some decent tutorial/documentation -- even if I have to pay for it...
It would be great to see something along the lines of the "FAQTutorial" but with more indepth look at available Velocity objects/macros and discussion of how Documents/Classes/Objects/Properties are actually related....
I can't believe this stuff isn't better documented :(

Documentation is done by the community, i.e. people like you. I agree it's a little bit disappointing that lots of users do not participate more to documentation since they get a software for free, ask a lot of questions and when they get their answers they don't even bother to reinject their knowledge into the documentation for the benefit of others. I hope you're not like these users! :)

I can help if you're ok to work on improving the tutorials with the missing information.

WDYT?

Thanks
-Vincent