names re-factoring
refactor2
first draft of the dev documentation