Move supermarq examples etc. to the Docs folder and include in documentation.

[cdbf1]

Move supermarq examples etc. to the Docs folder and include in documentation.

We may want to modify the descriptive .rst files so open to review on this.

Closes #1028