Making Better Examples
Tips for making code examples more clear
Issue: 14.2 (March/April 2016)
Author: Markus Winter
Author Bio: Markus is a Molecular Biologist who taught himself REALbasic programming in 2003 to let the computer deal with some exceedingly tedious lab tasks. Some call it lazy, he thinks it smart. He still thinks of himself as an advanced beginner at best.
Article Description: No description available.
Article Length (in bytes): 11,802
Starting Page Number: 33
Article Number: 14204
14204project.zip Updated: 2016-03-01 13:41:47
Related Web Link(s):
Excerpt of article text...
I'm always on the lookout for nice tips for the
Tips & Trickscolumn, so from time to time I go over all the latest Xojo related blog posts that I know of. So on the Xojo blog I came across a tip from Joe Ranieri on how to speed up text modifications on OS X (
It is a good tip, and we had already covered it in a previous issue (see
xDev12.4, Tips & Tricks, Tip 3). It is also a repost of a tip on the old REALsoftware blog from 2012 (
On reading it again and wondering why I don't use it much, I realized something that annoys me about so many tips and examples.
(Now let's be clear: being annoyed can be a good thing. Because it tells you there is something that can be improved upon and made to be less annoying—you just have to figure out what it really is that annoys you.)
At first I thought it was the following sentence, which I already moaned about it in 2012 when I pointed out the following as not being beginner-friendly:
...End of Excerpt. Please purchase the magazine to read the full article.