5,114 reputation
1937
bio website cellio.livejournal.com
location Pittsburgh PA
age
visits member for 3 years, 6 months
seen 1 hour ago

I'm an elected moderator on Mi Yodeya and The Workplace, and a pro-tempore mod here on Writers and on WorldBuilding. I'm pretty active on the SE network.

Professionally, I'm a technical writer who works with (and often helps design) programming interfaces. I've written programming guides, tutorials, reference applications (runnable examples), reference documentation (for Java, C++, C, SOAP, and REST APIs), and even a little user documentation. I'd love to see more technical-writing questions here on Writers!

A word of warning: if you are interested in the Biblical Hermeneutics site, I urge you to consider these words from a non-Christian who went down that path. They want people to help build their site (which they say is non-religious), but they allow Christian evangelism and presumption, quite a bit of it. Learn from another's mistake. See also: Working with idolaters, infidels, and the impious: can interfaith discourse work?


Apr
9
comment Do I need permission from people I am writing about if I am writing about a true story that was reported in the media?
Thanks what -- that would be great stuff to add to your answer.
Apr
9
comment Do I need permission from people I am writing about if I am writing about a true story that was reported in the media?
This is good advice, but I wonder if the fact that it has already been published changes anything. Invading someone's privacy is problematic; repeating what you saw in The New York Times (or The Podunk Gazette, whatever) seems different, and this is what the question posits. Could you address that angle?
Apr
7
answered How does one avoid incomplete changes to documentation?
Apr
6
comment How does one avoid incomplete changes to documentation?
Just to check, you're asking about cases where, say, some feature in the documented software changes, you update three places in the doc that are affected, and you miss a fourth place that also needed to change? (Because you can't just click "refactor" like in your IDE...)
Apr
4
comment Does self publishing via Amazon or similar services make your book ineligible for later acceptance by a publisher?
I would find this answer more helpful if you could cite sources (or personal experiences) to back up what you say. How do you know that publishers behave this way? Thanks.
Apr
1
comment Twist in kishōtenketsu vs. twist in Western plots
I'd never heard of kishoutenketsu before this question but now, thanks to this explanation, I think I have a basic understanding of it (which, now that you mention it, matches the limited manga and anime I've seen). Thanks.
Mar
26
awarded  Announcer
Mar
26
comment Present tense in user manuals
This depends on who the audience is. If the manual is for the system administrator and the statement is about what his users can do, this would be misleading. If "the users" are the audience, then I agree this is better. I'm a big fan of writing documentation in imperative tense.
Mar
26
answered How to reference a figure from text in a technical document
Mar
26
answered Stardate(Julian Day) - Problem
Mar
24
answered I need advice regarding the use of real-world locations in a novel
Mar
23
comment Is there any structure to write a book?
This feels very broad to me.
Mar
17
revised Present tense in user manuals
added 373 characters in body
Mar
13
awarded  Self-Learner
Mar
13
comment How can I write better code-based reference documentation for programming interfaces?
@dmm "all" is a stretch goal, but feel free to pass a link around to folks you know. :-)
Mar
13
comment How can I write better code-based reference documentation for programming interfaces?
@PaulA.Clayton oops, good catch -- fixed now. :-) I added a note about the difficulties of determining what the contract actually is; there's a larger software-design discussion there, but it feels like scope creep here. But it's important to note, so thank you for pointing it out.
Mar
13
revised How can I write better code-based reference documentation for programming interfaces?
added 165 characters in body
Mar
13
asked How can I write better code-based reference documentation for programming interfaces?
Mar
13
answered How can I write better code-based reference documentation for programming interfaces?
Mar
10
comment Coping with writer's block
Hi hyp3r and welcome to Writers. As Lauren noted, this question has been asked so I've marked it as a duplicate. I hope the answers to the other question help you. If you have followup questions (or ones on other writing topics) please feel free to ask them. Thanks, and good luck with your course!