Dev doco 2

as requested in pull request 133.