3 ms·
I like semi-automatically generated docs like AWS API docs that contains in minimum the type information for every field there is, and often much more. I don't
by Aperocky 3y ago
I like semi-automatically generated docs like AWS API docs that contains in minimum the type information for every field there is, and often much more.
I don't like Python docs where it ends up on long winded explanation for specific cases but does not cover all arguments, or only mention some in passing.
- mijamo 3y agoI am the exact opposite. I dislike semi automatic docs like most rust libraries have that don't tell you anything about how you're supposed to use things, and I love the general python docs that are the opposite. Django in particular is super good at this. I would compare it to having a recipe vs a list of ingredients. Both are useful but I can't just cook if you just give me a list of ingredients without instructions. And then you have NestJS that does neither so you just get a random piece of information but missing 75% of instructions and no good API doc.