update README and create dev-notes
first round of new documentation
first round of new documentation