Remix.run Logo
petetnt 5 hours ago

I agree with the general statement, if you didn’t spend time on writing it, I am not going to spend time reading it. That includes situations where the writer decides to strip all personality by letting AI format the end product. There’s irony in not wanting to read AI content, but still using it for code and especially documentation though, where the same principle should apply.

jimmaswell 5 hours ago | parent [-]

I find AI is great at documenting code. It's a description of what the code does and how to use it - all that matters is that it's correct and easy to read, which it almost certainly will be in my experience.

b2ccb2 3 hours ago | parent | next [-]

I have quite a different take on that. As much as most people view documentation as a chore, there is value in it.

See it as code review, reflection, getting a birds eye view.

When I document my code, I often stop in between, and think: That implementation detail doesn't make sense/is over convoluted/can be simplified/seems to be lacking sanity check etc…

There is also the art of subtly injecting humor in it, with, e.g. code examples.

archagon 5 hours ago | parent | prev [-]

Documentation is needed for intent. For everything else you could just read the code. With well-written code, “what the code does and how to use it” should be clear.