Re:Writing Well-Documented Code – Learn from Examples
by omegalulw on Saturday September 04, 2021 @06:47PM
(#28420076)
Yup, the rate limiter comments are unhelpful. A top level comment explaining the idea is fine (and very useful) but code should largely be self documenting.
[ Parent
| on HN ]
Re:Writing Well-Documented Code – Learn from Examples
by axiosgunnar on Saturday September 04, 2021 @08:04PM
(#28420574)
Which it often is, but they still wrote a comment, leading to ridiculous stuff along the lines of
> // Returns None is x = 0
if x = 0 { return None }