Clean up documentation and exclude anything marked @api private.

Had to rename EntryContainer::Generators::for_children_of_type to
follow a more conventional usage since yard wasn't picking up the
include within parentheses.