initial take on development section of documentation
close issue #2
close issue #1

close issue #3