Core documentation cleanup

After two tries this is the final one - it just cleaned up the documentation.