Posts by Monica Cellio
In addition to reading (as suggested by others), practice writing in contexts that are already available to you. (Starting a blog is good too, but if you can't build a reader base that can be disc...
Lauren's and SF's answers give good advice for dealing with the necessary explanation. My additional advice is: make sure it's really necessary. Driving a car is a pretty complex task (ask anyone...
Does the publication in question have relevant style guidelines? (I'm assuming not or you wouldn't be asking here.) In your proposed solution, you are using both formatting and (initial) explicit...
Historical re-enactors share your problem. Here are some of the things we do: Read history books, sure, but sometimes it's the museum catalogs that show everything from art to architecture to eve...
We have learned through experimentation that a new-enough version of Microsoft Word (we tested with 2010) supports format-preserving cut-and-paste from Stack Exchange posts. We drew up some format...
Over on another site we're talking about taking some of our content (on a particular theme) and re-packaging it as a printable PDF. (The primary use case is paper.) This wouldn't be a straight du...
A "Mary Sue" is a character who represents a highly-idealized version of the author (usually). This is the sort of character who, as needed, can perform brain surgery with one hand on a turbulent ...
Try something like this: This application is for users of (ESP) who need to understand its results quickly and easily. (Product) takes the metrics compiled by (ESP) and presents them in a way ...
Back when rocks were soft and the world wide web hadn't yet been invented, I worked on a college newspaper that, I was told, followed the same patterns as professional papers. (That is, the skills...
Unless you are near (what you think is) the end of your life, you don't have enough data yet to know what will ultimately be the best organization. So don't try to create an outline; just start wr...
I do something similar to your ASCII implementation, but instead of an ASCII block I use compact bulleted lists (with sub-lists). File/directory names are still styled as they would be in running ...
The ideas in this excerpt grab me. We have a first-person narrator who's dead; how does that work? This seems to have involved some sort of deal to help the narrator's son, and there seem to be a...
My experience is in software documentation (particularly programming interfaces), so I'll answer from that perspective. I think these principles are pretty general, but I've never written manuals ...
First off, if you're writing for the government they might have a format they expect, so if so and it says something on this point, it wins. Otherwise, I would not use colons in any of your titles...
For documentation that will be published outside your organization, it is usually important to follow a style guide (pretty much any one) so that all the documentation reads with one "voice" even t...
One resource is Techwr-l, a large, long-running mailing list and web forum. You can't just post job ads to the mailing list, but they accept ads/sponsorships. I've never advertised there so I don...
You have six sentences' worth of text in three conjoined sentences. Not all of the pairings are necessary and some might not be "correct"; for example, you could just as easily conjoin the questio...
One approach would be to record your story-telling sessions, particularly in a way that captures his reactions. You could then review those recordings to see what worked and what didn't (e.g. you ...
The up-hill battle you face is that there's a lot of material out there and publishers can afford to be choosy. Based on observation only (I haven't tried to get essay collections published nor am...
I'm answering this as a technical writer but I don't have translation experience so can't address any aspects specific to that. Many of the habits that (I hope) you already have as a software deve...
I agree with Lauren Ipsum's answer. Some additional points: The paragraph you posted for the cover letter talks about what you want to do, but you've actually done this. Call that out; lots of p...
I think it's three things. First, the accessible writing style, with its informal language that matches how regular people think and talk, is helpful but not sufficient. Second, the character's a...
A good SDK (software development kit) includes plenty of well-documented examples. It also includes good tutorials and developer guides, which introduce concepts in logical progressions, typically ...
For our SDK, we generate individual documents (PDFs) and one big HTML doc set (CHM file) from the same Docbook source. Each book has an index, and the HTML version has an integrated index that is ...
The challenge with publishing these days, especially with the great supply of e-books, is getting people to look at your stuff among all the competition. There's so much to choose from; if I've ne...