3 ms·
Couldn't agree more. Also, the worst fucking docs of all time come out of consulting teams where like 8 people have a superficial understanding of the system an
by BigJono 4y ago
Couldn't agree more. Also, the worst fucking docs of all time come out of consulting teams where like 8 people have a superficial understanding of the system and are all trying to collaboratively document everything. They just produce reams of unstructured nonsense that has no actual value whatsoever.
99% of the teams that think they have some decent bus factor actually just have bus factor 0 and survive by lighting piles of money on fire with an army of 0.01xers with high turnover and no chance for anyone to ramp.
Give me a single handover .txt file from a lone wolf any day of the week. In fact, that's the exact type of person I want to work with. Fuck "teamwork™" and fuck bus factor.
- BlargMcLarg 4y agoIt is crazy. We hear these stories all the time. We have clear examples of good and bad documentation. Yet in the same breath, we condemn loners who neither solve nor worsen the problem by default, and praise the social butterflies omnipresent in places with these symptoms present. Nothing is going to substitute throwing a few individuals with zero domain knowledge at your code/docs and seeing if they grasp enough. Certainly not some talking which fades away in 10 minutes.