I've been at a variety of places. Some startups, some star companies you've heard of. Yet at each of these places, the documentation is minimal, the code is terribly written with tribal knowledge needed everywhere, and management keeps aggressively trying to push out features before they're ready. Have I just been getting bad luck here? Or is well-written, well-documented, well-tested code something that doesn't really exist?
Ask HN: Why can't I find work with a well-documented code base?
1–10 of 13 posts
Re: Ask HN: Why can't I find work with a well-documented code base?
#2Haha. Yea, I've seen those patterns too. Since 1995. Its like nobody reads the books we all talk about.
Re: Ask HN: Why can't I find work with a well-documented code base?
#3[deleted]
Re: Ask HN: Why can't I find work with a well-documented code base?
#4Well this is the state of the industry. There certainly are companies with well-written, well-documented, well-tested code but they don't hire because they don't need to. Their code is easy to change and maintain, so why pay more people? This is all most project managers know - absolutely never improve the process or the tools, just throw more people at the problem, so that's why you were there.
Re: Ask HN: Why can't I find work with a well-documented code base?
#5Documentation, like code refactoring and unit tests, don't directly add value for the client. Most companies don't place a high emphasis on these.
Re: Ask HN: Why can't I find work with a well-documented code base?
#6Documentation, like code refactoring and unit tests, don't directly add value for the client. Most companies don't place a high emphasis on these.
Isn't that a weird thing? Every recruiter post I'm seeing talks about how to write unit test, write clear comments, choose methods (functions) name with care, document your code even if it looks silly and again write tests!.
It's like what everyone wants, but then neither needs...
Re: Ask HN: Why can't I find work with a well-documented code base?
#7Documentation, like code refactoring and unit tests, don't directly add value for the client. Most companies don't place a high emphasis on these.
Isn't that a weird thing? Every recruiter post I'm seeing talks about how to write unit test , write clear comments , choose methods (functions) name with care , document your code even if it looks silly and again write tests! . It's like what everyone wants, but then neither needs...
It seems as absurd to me as constructing a building without laying down foundations and having proper blueprints.
Re: Ask HN: Why can't I find work with a well-documented code base?
#8Haha. Yea, I've seen those patterns too. Since 1995. Its like nobody reads the books we all talk about.
Yep, Code Complete, Mythical Man-Month. They are so highly regarded, but nobody seems to follow them!
Re: Ask HN: Why can't I find work with a well-documented code base?
#9Well this is the state of the industry. There certainly are companies with well-written, well-documented, well-tested code but they don't hire because they don't need to. Their code is easy to change and maintain, so why pay more people? This is all most project managers know - absolutely never improve the process or the tools, just throw more people at the problem, so that's why you were there.
Considering leaving the industry because of this. Which is a shame because I really do care about good software.