improved the documentation, of course