Some of the public methods in the interface headers are missing doc comments; it would be good
to go over them and supplement where needed.
(Self assigning)