Some class-level docs on how a developer would use this would be useful for my review. And future bug-fixing self.