[EntityIterator] Improve documentation.
[EntityIterator] Make the test for random access iterator more thorough by
adapting dune-common's random access iterator test.
[EntityIterator] Fix naming issues found by the more thorough test.