CR changes to PR13

1) rename doc/ to docs/
2) Add sphinx markdown to the doc strings.
3) Some more minor changes