Documentation update

i hope there are not many mistakes...the core documentation is still missing...
not sure about the comma here