add mac .DS_Store to ignore
use metadata from package for conf documentation
init api documentation
add links to specifications
update docstrings