Remix.run Logo
zephen 3 days ago

> The "what" vs "why" distinction breaks down when your code encodes domain knowledge that readers can't infer from context.

Yes, there are multiples levels of knowledge, and the required level of commenting depends on the minimum knowledge expected of a reader in each of several dimensions.

In point of fact, the only thing that almost always can do without documentation is a different question, "How."