I imagine that this is the main function for which this module exists, so this may also be a good place for a code example. If there's one in the high-level comments then it could just reference that (or the comments could reference an example here).