4 ms·
That seem to be excellent advice. It touches on one of my pet peeves when reading articles. Why is it so hard for authors to provide examples? Many times they d
by bjourne 8y ago
That seem to be excellent advice. It touches on one of my pet peeves when reading articles. Why is it so hard for authors to provide examples? Many times they describe elaborate algorithms but do not describe how they would operate on real data so you have to try and decipher that. If you hadn't added the three examples to illustrate your point, I wouldn't have understood it. But since you added them I understood it perfectly!
- TheAceOfHearts 8y agoI don't think this is limited to articles! I'll often read the documentation for some library or tool and I'll encounter a weird flag or option where I end up wondering: what is this for? When you're not incredibly familiarized with a problem domain it can be hard to figure out the purpose of a lot of things. By providing real examples you also help the reader build up a mental index in case they ever have to deal with a similar problem.