Good code (programming.dev)

submitted 10 months ago by MarvinTheBot@programming.dev to c/quotes@programming.dev

2 comments fedilink hide all child comments

Good code is its own best documentation.
--Steve McConnell

More info

This post is created by a bot. If you want to contribute to this community, please take a look at the sidebar

top 2 comments

sorted by: hot top controversial new old

[-] FlickOfTheBean@lemmy.world 4 points 10 months ago

Sure, but please don't skip the actual documentation either lol

Sometimes I just want a list of inputs and outputs and I don't want to read through the source to find them.

I wonder how many perfect plugins I've passed over for the lack of decent documentation by now

[-] philwills@programming.dev 1 points 10 months ago

Often, the documentation explains the why... The code (without documenting comments of course) only every tells you how...

this post was submitted on 25 Sep 2023

5 points (85.7% liked)

Programming Quotes

272 readers

1 users here now

Every day, one and only one programming quote is posted by the bot.

The core idea behind restricting posting is to encourage discussion. One quote a day is hopefully a good way to do that.

If you want to submit a quote, please use the following Google Form: https://forms.gle/n9g34eSZ7GVA4mFD8

Credits

founded 1 year ago

MODERATORS