←back to thread

Examples are the best documentation

(rakhim.exotext.com)
409 points Bogdanp | 1 comments | 09 Oct 25 19:34 UTC | HN request time: 0.206s | source
Show context
gbalduzzi ◴[10 Oct 25 05:51 UTC] No.45535697[source]▶
You need both and there are no ways around that.

Examples let you grasp immediately how to use the library and provide you good starting point for your integration.

Detailed explanation of all params and configurations allows you to solve more complex problems and understand the full capabilities of the tool.

I am miserable when any of the two kind of documentation is missing.

The only exceptions are very simple libraries, where the example tells you already everything there is to know.

replies(2): >>45536399 #>>45544325 #
1. joemi ◴[10 Oct 25 22:03 UTC] No.45544325[source]▶
I'm honestly surprised there are people who think that only examples are fine. And I'm equally surprised there are people who think only reference docs are fine. It's so infuriating coming across a project that only has one kind and not the other.