Add a script to generate documentation from template library annotations

[jouvin]

More and more annotations are added, at least for public variable, in the template library. SCDB allows to generate XML files from these annotations (ant compile.annotions). It'd be good to have a script to process these XML files and generate html or markdown files from them.

[jrha]

Bumped to next release at workshop.

[wdpypere]

As discussed in the workshop we will attempt to document the schema with annotations. we need:

• a example on how to do it
• a way of parsing the output xml
  • with xslt?
  • a python script was mentioned to parse these. Any have the location of this?

[jrha]

I believe @njwilliams had something once upon a time...

[jrha]

I have the source from MS, I am sanitising and de-morganising it. I will open a PR soon.

[wdpypere]

good news!

[jrha]

See #78, I have tested it successfully against several repositories, it will need some changes to produce the documentation we want though.

[jrha]

@wdpypere?

[wdpypere]

@jrha I will be adding schema documentation based on the panc annotations to the component documentation on readthedocs, but documenting an entire template library is not in my scope today. Although the code supplied in #78 would be a very good start for anyone having a go at it.