many additions to the documentation and first runtests