As someone who’s written lots of API docs, and authored a training
course or two (one for Python, even, though it was over 20 years ago):
coming up with examples that are short enough to be digestible and yet
meaningful and not just completely contrived… is actually The Hard
Part. Work like that has happening in a few places, it just takes
someone to show interest in a specific module and discuss improvements -
things have to happen bit by bit,. Guess I don’t feel like it gets us
much to just generically say “there should be more examples”, if that’s
the conclusion of this thread.
2 Likes