On 2022-02-03 at 05:52:19 +0100, Cecil Westerhof via Python-list <python-list@python.org> wrote:
> 2qdxy4rzwzuui...@potatochowder.com writes: > > > FWIW, I'd find some way to tell users the units (seconds, milliseconds, > > fortnights, etc.) instead of making them wade through your code to find > > the call to (and possibly the [broken] help text of) Timer. > > You mean with docstring? Docstring, comments, error/exception text, external documentation, URLs or other references in the source code (docstring, comments), the name of the object in question (e.g., instead of "interval," call it "interval_seconds," or "seconds_between_runs"). *Something*. Or more than one of the above. A reference to the Timer class's documentation. There are a lot of options. Pick a place (or more than one!) that will be fairly conspicuous in as many situations to as many users (including future you) or potential users (including your future code) as possible. In a perfect world, you will receive feedback and/or use your own code, and improve your choice(s) and method(s) over time. -- https://mail.python.org/mailman/listinfo/python-list
