Decision-Making Training for Software Engineering

post by Alex Hollow · 2021-08-04T10:36:57.653Z · LW · GW · 6 comments

This is a link post for https://alexhollow.wordpress.com/2021/08/04/decision-making-training-for-software-engineering/

Contents

6 comments

I recently read this post that discusses the author’s experience leading military decision-making trainings for ROTC cadets during the pandemic. I’m going to briefly discuss what those decision-making trainings looked like, and how the principles could be adapted to teach software engineering effectively.

To quote from that article, a Tactical Decision Game (TDG) is a “deceptively simple military decision-making exercises usually consisting of no more than a map and a few paragraphs of text describing a situation. Students are placed in the role of the commander of a unit with a mission and a specified set of resources. You have some information about the enemy, but not as much as you’d like. Then something unexpected happens, upending the situation and requiring you to come up with a new action plan on the spot. Then, after issuing your new orders, you must explain your assessment of the new situation and the rationale behind your decision.”

So, you are given some initial information and make a guess on what to do based on that information. Then you are given more information and you have to figure out something new to do. That sounded a lot to me like watching software requirements change over time, and getting to see whether your initial data structures and code shape hold up to changes.

To adapt these trainings for software engineering, you could imagine a programmer be given a set of requirements, and they implement code for those requirements. Then, they have to either add or change the functionality. This will lay bare any issues with code maintainability that the old approach had. Run enough games like this, possibly paired with suggestions for improvement that clearly would have been easy to refactor or change, and programmers will learn how to write more maintainable code. I think this would be an excellent addition to any college “computer science” curriculum that wants to teach software engineering, and have a high amount of value for the amount of effort it takes.

6 comments

Comments sorted by top scores.

comment by Darmani · 2021-08-04T18:57:33.013Z · LW(p) · GW(p)

I've been running exercises like the one described here for nearly 5 years as part of my business ( http://jameskoppelcoaching.com/ ). They take the name "design exercises." It's done in both live and canned formats. Chief addition is that, in the live versions, the new features are chosen antagonistically.

 

Dagon in another thread claims "Making something that's maintainable and extensible over many years isn't something that can be trained in small bites." My long list of testimonials begs to differ.

comment by Dagon · 2021-08-04T14:54:53.352Z · LW(p) · GW(p)

This describes a high-severity operational event (network outage, crash bug, etc.) pretty well.  The call leader is organizing teams and devs to focus on different parts of diagnosis and mitigation, and there's tons of unknowns and both relevant and irrelevant information coming in all the time.

Many companies/teams do dry-runs of such things, but on-the-job training is most effective.  The senior people guide the junior people through it as it happens, and after a few repetitions, the junior people (or the ones who display maturity and aptitude) become the leads.

For "regular" software engineering, I'd rather not encourage the idea that short, distinct scenarios are representative of the important parts.  Making something that's maintainable and extensible over many years isn't something that can be trained in small bites.

Replies from: Alex Hollow, Alex Hollow
comment by Alex Hollow · 2021-08-04T15:28:23.980Z · LW(p) · GW(p)

On a separate note, I think that incidents are the opposite of this - that requires that people go through and find what is wrong immediately, because the response is urgent. If anything, a Root Cause Analysis after the fact would be more similar. Or possibly the outage investigation. You might be interested in Julia Evan's debugging puzzles, which are small-scale but good introductions. I could imagine similar scenarios with real servers (and a senior dev moderating) being good training on debugging server issues and learning new tools.

Replies from: Dagon
comment by Dagon · 2021-08-04T16:52:20.131Z · LW(p) · GW(p)

I should have been more specific that the post-mortem is a critical part of the incident handling.  I see a lot of similarity in tactical decision-making, both in the incident handling (the decisions made) and in the post-mortem (the analysis and rationale).  

Strategic decision-making, tradeoffs about solving a narrow problem simply or leaving room for a class of problems, with more complexity (and structures to handle that complexity), is a related, but different set of skills.

comment by Alex Hollow · 2021-08-04T15:26:09.753Z · LW(p) · GW(p)

There is some extent to which you need long-term software project experience to learn how to deal with maintenance and extensibility over multiple years. However, there is still some benefit for devs who are fresh out of college and haven't done software maintenance. A lot of junior devs realize their designs are bad when asked "What if you need to add X later?". And these decision making training games would help with that.

How would you feel about someone being given a pile of code, and having to add a feature that requires modifications throughout the codebase? That could be a decent simulation of working in a large legacy codebase, and could be used in a similar game context, where you do a debrief on what aspects of the existing code made it easy/hard to modify, and review the code that the dev playing the game wrote.

Replies from: Dagon
comment by Dagon · 2021-08-04T16:54:52.326Z · LW(p) · GW(p)

How would you feel about someone being given a pile of code, and having to add a feature that requires modifications throughout the codebase? 

I think this describes many internships or onboarding projects for developers.  My general opinion is that, when nobody's shooting at you, it's best to do this on real software, rather than training simulations. The best simulation is reality itself.