Easier Documentation for Scripting Reference

I just watched the scripting reference documentation at http://platform.xwiki.org/xwiki/bin/view/SRD/Navigation.

I had for a custom project the problem that i want to add good documentation on code level for java api AND scripting. I found a solution with a own annotation.

I attached the example. Maybe you want to use the idea to create a automated scripting reference out of the new releases.