Re:The Senior Engineer’s Guide to Helping Others Make Decisions
by cema on Monday November 13, 2017 @04:45AM
(#15685375)
Document your decisions, explain assumptions, limitations, and reasoning. It helps immensely.
Re:The Senior Engineer’s Guide to Helping Others Make Decisions
by aequitas on Monday November 13, 2017 @09:45AM
(#15686810)
Indeed, I also started moving from documenting what code does to explain what I intend the code to accomplish (because code already explains clearly find what it does by itself). By communicating at this level the overarching idea does not get lost and allows for much better refactoring or debugging.
I sometimes still find it a challenge to walk the line between sticking to a principle and letting it go. But it's my opinion you should always stay open to let any of your principles be challenged (by someone else or yourself). And it still surprises me how I can shatter some of my deep rooted principles because of a new/different look on things.