add the more documentation and more open article
fixes as requested in review
Merge pull request #45 from ligthyear/more-documentation-and-more-open

add the more documentation and more open article