Live data from Hacker News

Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

news.ycombinator.com

21–30 of 71 posts

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#21
It's in the same group as Pragmatic Programmer, Refactoring, Patterns of Application Architecture and the Gang-of-Four book for me. Still recommended for junior programmers as they're all teaching the core of good design.

However seeing as the better frameworks/languages/IDEs have internalised a lot of the learnings and that the specific conventions may be outdated - so just follow the recommendations for your platform/framework.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#22
post #5

Earlier quoted context omitted.

Agree, but sometimes looking for recent books with the same underlying message is better than going through the classic. I read the mythical man month recently and the examples often involving OS/360 development are brutally outdated. I couldn't relate and I had to force myself to finish.

The Mythical Man Month is also super anti-feminist, which I wish people talked about more if they're going to recommend that book.

The book's nearly 50 years old. Most books not written very recently are not going to adhere to contemporary values and mores. If you're not willing to offer generosity when reading them and pick the useful part and discard the parts that haven't aged well, then you're going to miss out on a lot of very worthwhile reading.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#24
post #13

I read it last year and I think it's still relevant. I had planned to write on the topic. In his book, Steve McConnell advocates for PPP = Pseudocode Programming Process Basically, he says you should outlines the structure of your code first, before writing your actual code. IMHO this is even more relevant in the age of AI assisted programming. Pseudocode Programming Process is becoming Prompt Programming Process. Th…

It's good advise and has helped me a lot over my 32 years of writing code (you pretty much had to pseudocode when I started as assembly isn't exactly expressive, especially for a young kid).

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#25
post #2

Good coding practices don't change much, so yes it is still relevant.

"Clean code" does change a lot based on IDEs and programming language. For example, we don't use variable names like mIntScore anymore. And we're finding that Javadocs might add little value and go out of date.

Architecture can change quite a bit too - all the async webs make things difficult. Most of the bug reports we get on mobile are not test coverable. e.g. some jankiness when going back to a page, or something like liking a post three levels down and finding that your like was not registered when you go back towards the home screen. We had some bugs like an OS modding text animations, making the text invisible in very niche situations. Then you have combos of ltr and rtl languages and layouts. Adding test coverage can be 4x the effort of writing the code once with no tests, not to mention the architecture for test support making things exponentially more complex.

Maybe we have to rethink what complete code really means.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#26

Earlier quoted context omitted.

I found this: https://www.goodreads.com/review/show/1461289590 "A team of two, with one leader , is often the best use of minds. [Note God's plan for marriage.]'" That is only sexist if he is saying that the man is naturally the leader. Did he say that?

At the time, it must have been the straight reading, right?

That is quite an assumption. But I don't know the full context of the quote.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#27
post #5

Earlier quoted context omitted.

The Mythical Man Month is also super anti-feminist, which I wish people talked about more if they're going to recommend that book.

I don't remember that. But I read it a long time ago. Can you supply a quote to back this up?

I don't have my copy with me so I can't supply an exact quote right now. The part that really stuck out was about companies relocating though. First, there was absolutely no possibility that women would be working, and iirc the primary reason that a company might not want to relocate was that a wife might complain her husband had to move, thus inconveniencing his boss. Something like this.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#28
post #5

Earlier quoted context omitted.

The Mythical Man Month is also super anti-feminist, which I wish people talked about more if they're going to recommend that book.

The book's nearly 50 years old. Most books not written very recently are not going to adhere to contemporary values and mores. If you're not willing to offer generosity when reading them and pick the useful part and discard the parts that haven't aged well, then you're going to miss out on a lot of very worthwhile reading.

That's one way to look at it. Another way to look at it is: Why do we not *update* these books? This gets back into the question of copyright of course.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#29
post #28

Earlier quoted context omitted.

The book's nearly 50 years old. Most books not written very recently are not going to adhere to contemporary values and mores. If you're not willing to offer generosity when reading them and pick the useful part and discard the parts that haven't aged well, then you're going to miss out on a lot of very worthwhile reading.

That's one way to look at it. Another way to look at it is: Why do we not *update* these books? This gets back into the question of copyright of course.

Because then we lose any sense of historical context.

Old books at their essence lets us talk to people from the past. We won't always like what they have to say, but they will speak about themselves and highlight how we've changed. If we can't understand where we came from, then we can't hope to understand how we got where we are.

Re: Ask HN: Is "Code Complete" by Steve McConnell still a recommended read?

#30
post #5

Earlier quoted context omitted.

Agree, but sometimes looking for recent books with the same underlying message is better than going through the classic. I read the mythical man month recently and the examples often involving OS/360 development are brutally outdated. I couldn't relate and I had to force myself to finish.

The Mythical Man Month is also super anti-feminist, which I wish people talked about more if they're going to recommend that book.

[flagged]
Post reply on HN