One important aspect for me with documentation (particularly with areas I don't understand) is examples and scenarios. It can help take more abstract concepts and make them more concrete.
I don't know much about documentation tools though from me as a user, I've really liked the documentation that Stripe has (both its very thorough API documentation and its less-API oriented documentation).
One important aspect for me with documentation (particularly with areas I don't understand) is examples and scenarios. It can help take more abstract concepts and make them more concrete.
I don't know much about documentation tools though from me as a user, I've really liked the documentation that Stripe has (both its very thorough API documentation and its less-API oriented documentation).
Examples and scenarios can definitely be useful in documentation!