Further simplify the iterator API.

This removes the unnecessary '==' operator, and adds documentation
noting that the ranged-for mutable methods are considered implementation
private.

Issue: PLCR-527