closes #6
round one of documentation
Merge branch 'experimental'