Message316202
I've always expected that documentation for a module can assume that the module itself, and/or the function being described, has been imported.
On the other hand, I have no objection to making this explicit, especially in the recipes section where it might not be as clear which functions come from the module and which are builtins.
I'm inclined to go for your 2nd option, import the module and use a full-qualified name:
password = ''.join(secrets.choice(alphabet) for i in range(8)) |
|
Date |
User |
Action |
Args |
2018-05-05 09:14:29 | steven.daprano | set | recipients:
+ steven.daprano, docs@python, dchimeno |
2018-05-05 09:14:29 | steven.daprano | set | messageid: <1525511669.86.0.682650639539.issue33430@psf.upfronthosting.co.za> |
2018-05-05 09:14:29 | steven.daprano | link | issue33430 messages |
2018-05-05 09:14:29 | steven.daprano | create | |
|