The Agile Embedded Podcast

Living Documentation with Philip Markgraf

16 snips
Jan 30, 2024
Philip Markgraf, an experienced software developer with expertise in Agile methodologies, dives into the evolution of documentation in software development. He shares how streamlined documentation has become a valuable asset, especially in regulated industries. The discussion covers the importance of unit tests as dual-purpose documentation and the challenges of automatic document generation. Philip also emphasizes the cultural shifts in teams post-merger and the role of effective testing in enhancing product quality. Lastly, he highlights the significance of collaboration in coding practices.
Ask episode
AI Snips
Chapters
Books
Transcript
Episode notes
ADVICE

Implementing TDD in Embedded Systems

  • Start with small steps when implementing new practices like TDD in embedded systems.
  • Begin by introducing pair programming and focus on integration tests as a starting point.
ANECDOTE

Automated Integration Tests

  • Phil's team used Lua scripting and an existing testing framework to create automated integration tests.
  • These tests ran nightly and provided a foundation for their continuous delivery journey.
INSIGHT

Unit Tests as Design Documentation

  • Unit tests serve as valuable documentation of a system's intended behavior.
  • Writing unit tests upfront is an act of design, more valuable than post-hoc verification.
Get the Snipd Podcast app to discover more snips from this episode
Get the app