How about this:
Humans (or humans assisted by AI) write documentation
Users (devs included) can either choose to read the manual the old fashioned way or utilize it like a sort of swagger api documentation to give
Information to a question (How to do x)
Provide a general example
(Assuming it’s used with an IDE or has information about the project) Provide a personalized example on the implementation.
How about this:
Humans (or humans assisted by AI) write documentation
Users (devs included) can either choose to read the manual the old fashioned way or utilize it like a sort of swagger api documentation to give