Anthony Madrid: When teachers wish to nurture expressiveness in young people, they (the teachers) should make a point of sharing with the kiddeos selections from writers’ notebooks. These show the beginner that a master’s seedlings don’t look that different from her own. Then teach the beginner to keep such a notebook! Excellent phrases overheard, witty lists, ideas for stories…. The front side of one sheet of paper might be enough to undo the damage of having heard that you either got it or you don’t.
Write the Docs is a place where the art and science of documentation can be practiced and appreciated. There are a lot of people out there who write docs, but there isn’t a good place to go to find information, ask questions, and generally be a member of a community of documenters.
But there is one area of human endeavor that comes close to exemplifying the maxim “manuscripts don’t burn.” That area is mathematics. If Pythagoras had not lived, or if his work had been destroyed, someone else eventually would have discovered the same Pythagorean theorem.
A scrupulous writer, in every sentence that he writes, will ask himself at least four questions, thus: What am I trying to say? What words will express it? What image or idiom will make it clearer? Is this image fresh enough to have an effect? And he will probably ask himself two more: Could I put it more shortly? Have I said anything that is avoidably ugly? But you are not obliged to go to all this trouble.
The following three suggestions should make people using computers happier in BigOrgName. 1. Use plain text format for all written text documents. Because: Sustainability. Plain text both ensures transparency and answers the standards of long-term preservation. MS Word may go the way of Word Perfect in the future, but plain text will always remain easy to read, catalog, mine, and transform. Furthermore, plain text enables easy and powerful versioning of the document, which is useful in collaboration and organizing drafts.
But you’re not a writer, so this isn’t your problem, right? Well, the thing is, writing is not some mystic art. It’s a practical skill—particularly since most of our online communication is text-based to begin with. When you write about your work, it makes all of us smarter for the effort, including you—because it forces you to go beyond the polite cocktail-party line you use to describe what you do and really think about the impact your work has.