finish the core documentation, do some general tweaks