That’s the one problem. An LLM enhanced terminal sounds great. Sharing every command with the cloud does not.

I’ve had that article saved for years, it’s still the best way to break down documentation imo.

Another key point for code documentation is that the closer it is to the code it’s describing, the more likely it is to be read and maintained. The book “A philosophy of software design” has a section on it.