Hi,
I mark your words, and followed all the corrections you suggested.
i think that accessing objects attached to an XWiki page from inside a
plufgin is somthing very basic, that should be documented. I guess its ok to
redirect to the API guide, which has examples for velocity, since there is a
direct mapping from Velocity to Java. Developers should hopefully figure it
out without problems. So there should be a few more lines in the velocity
snippet of the API Guide, not just to set but also to get fields. Having the
java perspective as well might help, so you could have both a velocity and
java snippets on the guide.
Its a good idea to have an API guide, so as to structure the documentation
(instead of having everything in one huge page :-) )
i guess the most useful thing regarding API for plugins would be to have
the javadoc fully documented (one sentence for each method), but i dont know
what are your documentation standards
And do you think that documenting DWR in a tutorial is a good idea, since
it fulfills a basic need for xwiki developers ? Are you ok with that ? Its
not something from xpn, after all.
LMKYT, R (Let me know your thoughts, regards :-) )
And i will probably contribute some tutorials for plugins, since i am
working on xwiki for my final internship, and i ll have to write a report
anyway. So i might as well write info available for the community, instead
of putting together a useless report that nobody will reuse at my school.