programming

First, let me give you a bit of background. At my company we’re looking for a way to create and share internal documentation with a git and Markdown-based documentation service. The reasons behind these choices are that (1) Markdown is simple to use and all the developers know how to use it; and (2) a git-based service will help us track documentation changes and agree on improvements by using pull requests and “doc reviews” before merging any changes....

During my short career as a software engineer, I’m often surprised that many people in the industry are unaware of rules of thumb—heuristics— managers and programmers have discovered to better navigate almost any situation. There’s always that new story about a team that was very cooperative but broke down and became hellish once it grew too much. Or your friend telling you a story of a surprising bug that took hours to solve and it turned out the solution has just a couple of lines away from where the code was edited last....