Episode 17: Why software developers hate documenting (and how to help them)

Episode 17: Why software developers hate documenting (and how to help them)

HomeAirManualEpisode 17: Why software developers hate documenting (and how to help them)
Episode 17: Why software developers hate documenting (and how to help them)
ChannelPublish DateThumbnail & View CountDownload Video
Channel AvatarPublish Date not found Thumbnail
0 Views
Most software developers and managers hate documenting.

What’s more, they openly express their distrust that the effort of documentation will ever pay off.

Why this?

It is based on a misconception about what needs to be documented.

Engineers see well-maintained technical documentation and best practice documentation and assume that the goal is to reproduce it.

But that's a pointless exercise. By the time you've created documentation with that level of detail, teams have already made weeks of progress and the content you've created is already out of date.

Instead, we need to link all our documentation to business processes.

Instead of having a document titled “System Architecture,” you may need to update your documented peer review process. Or add a “Learn about our architecture” step to onboarding.

In this episode of De-stress Your Business, we take a closer look at the misconceptions that can hold software development teams back and how to combat them.

Please post your questions in the comments.

Want to learn more? Join our weekly webinar and we'll show you how to free up 15 hours a week and relieve the constant stress of running a business without slowing down growth. Find all the details at www.airmanual.co/webinar!

Please take the opportunity to connect with your friends and family and share this video with them if you find it useful.