I wonder why yardstick did not flag this. Looks like all these methods need `@example` sections, since they are part of the public api.