I’ll be celebrating my fifth year as a Masherite in early July. It’s been a wild ride. In my very second week of work, I was asked to speak at a local meetup on behalf of the company on any topic I wanted relating to APIs. I could have chosen to speak on good RESTful design or how to design the underlying architecture to best support a truly scalable system, but those paled in importance compared to the topic I chose: Developer Documentation.
Five years later, I maintain that poor documentation is still the greatest hindrance to developer success — more so than monolithic legacy architectures, un-typed scripting languages, or byzantine release processes. Poor documentation can’t be fixed with something like microservices, or adopting the Go language, or integrating your code repositories with continuous testing and deployment tools. Documentation is a human problem that can only be solved by human intervention. https://goo.gl/1auHeX #DataIntegration #ML
Share this:
- Click to share on Facebook (Opens in new window)
- Click to share on Twitter (Opens in new window)
- Click to email a link to a friend (Opens in new window)
- Click to share on LinkedIn (Opens in new window)
- Click to share on Tumblr (Opens in new window)
- Click to share on Pinterest (Opens in new window)
- Click to share on Reddit (Opens in new window)