4,870 reputation
1935
bio website cellio.livejournal.com
location Pittsburgh PA
age
visits member for 3 years, 4 months
seen 4 hours ago

I'm an elected moderator on Mi Yodeya and The Workplace, and a pro-tempore mod here on Writers. 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?


May
30
comment How to sift through all those illustrators?
@what it's possible that there are reliable recommendation/rating services, or professional associations with guidelines, or something like that.
May
26
comment How can I create better suspense in this passage?
Thanks, I've reopened.
May
25
comment How can I create better suspense in this passage?
Hi and welcome to Writers. Critique questions here need to have specific questions; more information can be found in our critique guidelines. I'm placing this on hold for now, but please feel free to edit this and we'll consider reopening.
May
25
comment How can I write better code-based reference documentation for programming interfaces?
Thanks for calling out types (like List) that by themselves don't convey all the necessary information. This used to be a problem in Java too (great, it returns a Collection... of what?) before generics entered the language. But even specifying the type of the members of an array/list/collection/etc isn't necessarily sufficient.
May
21
comment How To Cite Francis Bacon's Of Simulation and Dissimulation Essay
Where did you read the essay? Any reason not to cite that source, whatever it is, as your source?
May
18
comment 3 short stories that can be turned into a novel. Should I pick the one with best reviews?
If you had no external feedback on any of them, which would you choose? That is, are you particularly passionate about one of them, or is your interest about equal for all of them?
May
11
comment How can you represent music in writing
What aspects of the music do you want to convey? Melody/harmony? Tempo? Volume? Lyrics?
May
9
comment How can I (as a new author) publish a collection of essays?
Hello and welcome to Writers. I've made some changes to your question to focus it more on the problem you're trying to solve and less on the discussion-forum aspect. I also added a link to the question you referred to; can you edit to explain what you're looking for that's not addressed there? Are you specifically interested in publishing a collection (as a book or e-book), or would blogging or serialized publishing (like in magazines) meet your need? Please edit to clarify. Thanks.
May
2
comment Dashes vs. Commas vs. parentheses?
xkcd.com/859 :-)
May
1
comment Preventing units from being “broken” to the next line
Sorry about the weird tagging accident there. Not sure how that happened, but fixed now.
Apr
28
comment Author order and grouping on technical document
Yeah, sadly that's pretty common for test reports. Make those first 30 seconds good -- maybe an explosion will help? :-) But more seriously, who is the audience community -- people within your institution, people within your field, the whole Internet, etc? What you do with authors is probably affected both by how known/credentialed any of those people are and the norms of the community in question.
Apr
28
comment Author order and grouping on technical document
I take it this is for publication in a journal or a conference proceeding?
Apr
18
comment Should you specify camera action in a film script?
Hi and welcome to Writers. Could you add something about why you feel this way? Right now this just sounds like your opinion. Is it industry practice that directors decide that? (How do you know?) If it is, would putting them in change anything? (How do you know?) Etc. Thanks.
Apr
17
comment How can I find an agency for copywriting/script writing (for advertising) in the UK?
Hi bels and welcome to Writers. I've edited your question to make it fit better with Stack Exchange norms. Questions asking for lists or recommendations don't work well; they're pretty subjective and it's hard to evaluate the answers. But your core problem seems to be "how do I find them?", so I've changed your question to ask that. (It's possible that, if there are clear frontrunners in this area, some specific suggestions will come up in answers.) Thanks for understanding, and please feel free to edit further if I've misunderstood you.
Apr
16
comment Do acknowledgements have to come after the table of contents?
If you're doing e-books, one factor to consider is what makes it "above the fold" in the preview. Unless you're being really verbose it probably doesn't make a difference here, but it's something I would want to check.
Apr
16
comment Is it considered ethical to accept payment from a business for reviewing a product or service?
@JohnFeminella could you add what you said here (about common-used standards) to your question? This is an interesting question but does skirt close to the opinion-based close reason -- but I think that change would make a big difference. Thanks.
Apr
14
comment Fan works… are they allowed?
"Are they allowed" in what sense? Are you asking an ethical question (is it right and proper that I do this)? That isn't usually a good fit for Stack Exchange as it's primarily opinion-based. Could you focus this more on your publication goal? A question asking how far you can deviate from the norms of the fandom and still get your stores accepted for publication would probably work better. Thanks.
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
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...)