Extension documentation for website

[ant elder <an...@gmail.com>]

I've started on a website page documenting the script container, still a
very rough draft, but I'm wondered whats required for the documentation of
each extension.

What i'd like to do is get the doc for one extension looking ok so it can be
used as a template for all the others, and then just copy the xml, editing
the content where required for the particular extension. For things like all
the script containers the doc will be be very similar, even for different
extension types there's likely a lot of common xml and it would be good to
have the doc for them all looking similar.

The one I've started on is at:
https://svn.apache.org/repos/asf/incubator/tuscany/sandbox/ant/container.script/doc/sca-java-container-script.xml.
To build that you need to check out the site and copy that to the
site-author directory and build the website as described at:
file:///C:/SCA/SVN/site/site-publish/site_development.html.

So are there any suggestions on the content, layout, required sections etc
that would be a good model? More text / less example scdl? For each
container should there be examples for things like references and properties
or should those be assumed to be described elsewhere? More/less detail about
why the particular extension is useful? Use cases showing how you might use
it?  Or anything else you can think of? I'm a bit rubbish with designing web
pages so would anyone else like to help or take this on?

   ...ant