more documentation, consistency fix