made self-documentation clearer