Ah, simplicity. Elegant. Succinct. Basic. Good. Welcome to ASI, new writer. Here are the basics: Write well, quickly, in the active voice and the present tense. Put punctuation outside the quoted material. Maintain gender neutrality. (“He” and “she”: bad. “They”: good.) Replace semicolons with periods. Use numerals for all numbers. Make cross-references target-neutral. Insert AIT […]
DITA and wiki – w/ho/w will (we/you) write
I received an excellent question from a reader about his eagerness to use wikis for his product’s doc set, but he came across conflicts and issues when he questioned the practicality of maintaining a wiki for his large set of documentation. Here’s Paul’s well-phrased request for information. I am considering using a wiki for documentation […]
Feedburner support – they help until it sticks
I want to extol the virtues of Jon Klem at Feedburner, plus give a status update for this feed and the old TalkBMC feed. Now the feeds have been combined into one, bringing subscribers over with no interruption, and Jon stuck with me for no less than a 16-email message thread so that he and […]