made the documentation comments a bit clearer