File tree Expand file tree Collapse file tree 1 file changed +2
-2
lines changed Expand file tree Collapse file tree 1 file changed +2
-2
lines changed Original file line number Diff line number Diff line change @@ -118,7 +118,7 @@ I learned in school that comments are good practice?
118
118
119
119
They were exaggerating for effect.
120
120
There is definitely a place for comments that add context and intention.
121
- But my colleagues were pointing that comments aren't always as useful as you hope.
121
+ But my colleagues were pointing out that comments aren't always as useful as you hope.
122
122
For starters, it's pointless to write a comment that just repeats what you're doing with the code:
123
123
124
124
[role="skipme"]
@@ -153,7 +153,7 @@ Check out this video by the great Dave Farley if you want a taste:
153
153
https://youtu.be/JDD5EEJgpHU?t=272
154
154
].
155
155
156
- For more on comments, I recommend John Ousterhoudt's _A Philosohpy of Software Design_,
156
+ For more on comments, I recommend John Ousterhoudt's _A Philosophy of Software Design_,
157
157
which you can get a taste of by reading
158
158
his https://web.stanford.edu/~ouster/cgi-bin/cs190-spring16/lecture.php?topic=comments[lecture notes from the chapter on comments.]
159
159
*******************************************************************************
You can’t perform that action at this time.
0 commit comments