Re:Ask HN: What makes a piece of code enjoyable to read?
by whytheplatypus on Monday December 30, 2019 @05:06PM
(#21917095)
I really appreciate the response!
I've added TensorflowJS and MagentaJS to my reading list.
I'll pick out a couple of things implied in your comment, if I'm interpreting them right:
- An API should feel natural, and human-readable
- A codebase should have a flow or consistency through it, in naming and structure.
I couldn't agree more about the comments, it seems like the most useful comments are those that supplement a piece of code with references or context rather than reiterate the code itself.
I've added TensorflowJS and MagentaJS to my reading list.
I'll pick out a couple of things implied in your comment, if I'm interpreting them right:
- An API should feel natural, and human-readable - A codebase should have a flow or consistency through it, in naming and structure.
I couldn't agree more about the comments, it seems like the most useful comments are those that supplement a piece of code with references or context rather than reiterate the code itself.