to maintain consistency, you should add the `Example` portion of the rdoc like in all other methods in this class.