I tend to flip between two extremes: Code where I write few/no comments, because the API is intuitive, straightforward, and free of weird edge cases or unexpec

I tend to flip between two extremes: Code where I write few/no comments, because the API is intuitive, straightforward, and free of weird edge cases or unexpected differences, with any constraints well encoded by the type system, with everything relatively obvious from naming conventions, etc. Code where I write more comments than code. It might still be a good API, but I can't fully encode the edge cases into the type system, or maybe there's some subtle internal edge cases, or it's unobvious why you would need some code that happens to be a bugfix, or [...]