We talk about undocumented design decisions, how to (and how not to) document them.
Some highlights:
- Those things inherited from past engineers where nobody knows why it was done that way.
- Architectural design diagrams - Level 0 and Level 1.
- Keeping design decisions in the readme.md file.
- Onboarding new engineers, methods: 1) full classroom training 2) assign a small task 3) assign a mini-project.
- How some companies do it: MillenniumIT/LSEG, WSO2, :Different, ADL.
- How not knowing the big picture can be frustrating for developers.