Timeline for Self-documenting Code vs Commented Code
Current License: CC BY-SA 4.0
34 events
| when toggle format | what | by | license | comment | |
|---|---|---|---|---|---|
| Feb 5, 2024 at 11:27 | history | edited | peejay | CC BY-SA 4.0 | Remove dead link to comment. Remove unnecessary sentences at start. Edit for readability and consistency. Fix code blocks. |
| May 2, 2020 at 12:00 | history | tweeted | twitter.com/StackSoftEng/status/1256554057239597056 | ||
| May 2, 2020 at 11:46 | answer | added | Thorbjørn Ravn Andersen | timeline score: 1 | |
| Sep 4, 2013 at 12:59 | history | reopened | CommunityBot | ||
| S Sep 4, 2013 at 2:06 | history | notice added | user28988 | Comments only | |
| S Sep 4, 2013 at 2:06 | history | locked | CommunityBot | ||
| Sep 4, 2013 at 2:06 | history | closed | CommunityBot | Duplicate of "Comments are a code smell" [closed] | |
| Sep 4, 2013 at 1:37 | review | Close votes | |||
| Sep 4, 2013 at 2:07 | |||||
| Sep 3, 2013 at 23:30 | answer | added | dallin | timeline score: 9 | |
| Sep 3, 2013 at 20:54 | comment | added | dallin | Your preferred method is essentially using function calls to comment your code. Why not use comments for that? Functions should be used for reusable code only. I personally hate having to follow someone else's code written in this manner for the same reason the GOTO statement is evil - It creates spaghetti code. This is made better by modern IDE's, but not every language and programmer can use these IDE's and it's still disorienting. Honestly, I agree that you should comment sections of code that are not clear at a glance - it just makes reading through your code so much quicker and easier. | |
| Feb 26, 2011 at 8:02 | vote | accept | Phill | ||
| Feb 25, 2011 at 3:23 | answer | added | crosenblum | timeline score: 1 | |
| Feb 25, 2011 at 0:48 | answer | added | Coyote21 | timeline score: 1 | |
| Feb 24, 2011 at 22:43 | answer | added | Abbafei | timeline score: 1 | |
| Feb 24, 2011 at 21:30 | answer | added | Job | timeline score: 1 | |
| S Feb 24, 2011 at 21:15 | answer | added | guillaume31 | timeline score: 1 | |
| S Feb 24, 2011 at 21:15 | history | made wiki | Post Made Community Wiki | ||
| Feb 24, 2011 at 14:28 | answer | added | Steven Jeuris | timeline score: 24 | |
| Feb 24, 2011 at 14:22 | answer | added | Peter Turner | timeline score: 0 | |
| Feb 24, 2011 at 13:57 | answer | added | JeffO | timeline score: 1 | |
| Feb 24, 2011 at 13:20 | answer | added | Rune FS | timeline score: 0 | |
| Feb 24, 2011 at 13:07 | answer | added | SK-logic | timeline score: 2 | |
| Feb 24, 2011 at 13:06 | answer | added | biziclop | timeline score: 84 | |
| Feb 24, 2011 at 13:01 | answer | added | Joris Meys | timeline score: 3 | |
| Feb 24, 2011 at 13:01 | answer | added | Sergio | timeline score: 2 | |
| Feb 24, 2011 at 12:59 | answer | added | user6791 | timeline score: 2 | |
| Feb 24, 2011 at 12:54 | answer | added | gablin | timeline score: 1 | |
| Feb 24, 2011 at 10:17 | history | edited | Phill | CC BY-SA 2.5 | added 4 characters in body |
| Feb 24, 2011 at 10:03 | answer | added | vegai | timeline score: 6 | |
| Feb 24, 2011 at 9:39 | answer | added | Rook | timeline score: 42 | |
| Feb 24, 2011 at 9:34 | answer | added | Péter Török | timeline score: 49 | |
| Feb 24, 2011 at 9:24 | answer | added | DistantEcho | timeline score: 1 | |
| Feb 24, 2011 at 9:23 | answer | added | James Love | timeline score: 1 | |
| Feb 24, 2011 at 9:14 | history | asked | Phill | CC BY-SA 2.5 |