4,619 reputation
1834
bio website cellio.livejournal.com
location Pittsburgh PA
age
visits member for 3 years, 2 months
seen 9 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.


Jul
18
comment Good Examples of and Practices in Code Documentation
Hi and welcome to Writers. I'm always happy to see more tech-writing questions here. As written this is pretty broad, though, and it seems like it will lead to an opinion survey more than good solid answers. Could you perhaps pick one aspect of this kind of writing and ask about that? Maybe you're trying to write tutorials, or docs for something that supports a lot of user customization (imagine trying to document Firefox in the face of add-ons and userscripts), etc? Are you asking about organization, use of examples, phrasing, user assessment, etc? Thanks.
Jul
17
comment How to start my prologue?
@user10143 welcome to Writers. In the future, please edit the existing question instead of creating a new one. Thank you.
Jul
16
comment How to deal with two ISBN from two different countries?
Have you been told you'll need two ISBNs, or are you assuming that different countries = different ISBNs? If you've been told this, can you edit to add some info about who told you (publisher? editor? some guy at Starbucks? :-) ) and, if you know, the reason. Generally, as the others said, it's one book + one ISBN.
Jul
15
comment Good tools for writing (game) manuals and sourceobooks
Thanks for the updates!
Jul
15
comment Master's Thesis Structure: Separate-Page Chapters or Same-Page Sections?
I'm missing the connection here -- what does right-hand-page formatting have to do with when the work is done? If the final document is done by cut/paste or xinclude of all the parts, why does formatting make that easier?
Jul
15
comment Good tools for writing (game) manuals and sourceobooks
Welcome to Writers! Can you add a bit to the question about the make-up of such books? I'm imagining that you have a higher-than-average number of charts, tables, and illustrations, some of which might be large. Knowing how much of what kinds of content you're trying to accommodate, beyond just the text, will help people give you better answers. Thanks.
Jul
6
comment How to Describe a Scene from Video?
If one of the answers here gave you what you needed, you can mark it as the accepted answer by clicking the check mark under the voting buttons. If you figured it out on your own, it would be best if you were to add an answer explaining what you did, since the answers here are for the whole Internet and not just for the person asking the question. Thanks.
Jul
3
comment What to write in an impressive about me section
Hi user10024 and welcome to Writers. I agree with what Andrew and Lauren said; what you're asking will fit better on Academia, but feel free to bring your "how to actually convey that in writing" questions here as they come up. I'll migrate for you.
Jul
3
comment Jumping between points in time in narrative
Asking if something is "acceptable" is pretty opinion-based. I think it would be better if you asked how to convey that -- if telling a story out of order like this is your goal (and yes, I've seen it), how can you make that easy for the reader?
Jul
2
comment Is it safe to create a wiki for a book (or something featured in it) before the book is published?
Can you flesh this out more? Why do you make this recommendation -- have you seen it? Done it? Talked with publishers? We're looking for answers that explain why and how, not just personal opinions. Thanks.
Jun
29
comment Is this title suitable for a chapter section?
I agree with this advice in general, but it does depend on who the readers and customer are. For programming doc for commercial products I've done this a lot, but I was more formal when writing for certain government customers. You need to look at the "ecosystem" your doc will fit into.
Jun
23
comment Resources for character development
Along with many of the questions from that list I was once asked "how does he spend a typical day?". While it seemed odd at first, doing it led to fleshing out interests (beyond the "main" one for the plot), hobbies, habits, etc.
Jun
18
comment Write a presentation of a dissertation
Other question: writers.stackexchange.com/questions/12210/…
Jun
18
comment Write a presentation of a dissertation
When a question is put on hold please fix the original question rather than asking a new one. This is an improvement over the other but it's still asking what to write (what points to talk about), which is off-topic here. A question about how to write an effective summary would be on-topic if you want to edit this to be about that. Putting this on hold pending that edit.
Jun
17
comment Choosing between your Mother Tongue and other language
@what more-literary fiction can run into problems too (imagery, metaphors, etc), but I agree that a professional translator can handle pretty much anything there (and didn't mean to imply otherwise). Heck, even poetry gets translated sometimes. I just meant that it's hard, therefore requires pros, therefore has a cost.
Jun
17
comment Best Tool to Create User Guides
@MartinMcCallion sounds handy! Do you happen to know which ones? Is this per-page only or do some take a page hierarchy and bundle it up into one PDF?
Jun
10
comment RDF vocabularly for storytelling
@sh1ftst0rm thanks for the clarifications. It's an interesting question; I hope we're able to help you. I've made some edits based on your comments and reopened.
Jun
10
comment RDF vocabularly for storytelling
Is the question about tools or encoding? That is, are you asking for an RDF tool, or are you asking how you could model plot in an RDF-ready way? (I imagine that most RDF-coded semantics are about facts or nouns, while plots are built around actions or verbs.)
Jun
6
comment How do you describe a methodology of writing?
Are you affiliated with this site? If so please disclose that. Also, if you want to link to that site, please link to the specific page where you found these guidelines. I'm going to edit out the promotional link in the meantime as it doesn't help to answer the question. Thank you.
Jun
5
comment Best Tool to Create User Guides
Oh yes, you definitely need a table of contents or it just turns into a digital junk drawer. :-)