I totally agree! Especially for highly experimental features/libraries. I am trying to finish a small new library today, and I'm basically following the docs I wrote a week ago:
https://github.com/franciscop/premonition
Code examples are very important in these situations.
The main issue I've found is that some times I like the docs I wrote, but I don't do the implementation and feel like I wasted my time by documenting too much. These times it might be because it was just a thought experiment, a wild idea tat I had to write down or I just have other priorities.
Code examples are very important in these situations.
The main issue I've found is that some times I like the docs I wrote, but I don't do the implementation and feel like I wasted my time by documenting too much. These times it might be because it was just a thought experiment, a wild idea tat I had to write down or I just have other priorities.