Field note · 7 March 2026
Naming scripts for people who inherit them
File names and function names are part of the handoff. Clever abbreviations punish the next shift.
A script called fix2_final_v3.py tells an operations supervisor nothing. A script called monday_inventory_confirm.py at least points to the calendar ritual.
Prefer boring clarity
- Include the business event in the name
- Avoid initials only your project chat understands
- Match log file names to the script name
Comment the why
Comments should explain vendor quirks and shift constraints, not restate for loops. The reader at 2 a.m. is an operations person with limited patience for jargon.
This is small craft, but it is how Python automation consulting leaves something durable instead of a private dialect.