Documentation update

i hope there are not many mistakes...the core documentation is still missing...
, ?