Post #2050532

@Lacey Thank you for the compassion! I am with you on the “why”. Code should be self-describing, so the docstrings are there to: 1. Summarize the contents (reduces cognitive load). 2. Explains intentions, caveats, and philosophy, if needed. 3. Optionally shows implementation examples (although I’m personally not a fan). Clean code is such a weird concept. Code can be too clean, which means it’s without context. It’s like a house that is staged for sale, or a hotel room: it has the necessities to survive, but you wouldn’t live there.