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.


Feb
6
comment How to display URLs in a textbook?
There might be style guides out there that address this. I assume those would count as "credible sources". (By the way, the bounty language is SE boilerplate; the bounty-giver didn't write those words.) The web has been broadly available for 20 years now; I would hope that there are industry standards (note plural :-) ) for how to deal with this problem.
Feb
6
comment How to reference a figure from text in a technical document
Are you following a particular style guide? If so, which one?
Feb
3
comment How to display URLs in a textbook?
Also, if you drop the "http://", then the first time you need to use "https://" you have a problem -- your URLs are either wrong or inconsistent in appearance. Don't confuse your readers like that.
Feb
3
comment How should I handle repeating parts in a technical description?
Can you say more about how the documentation will be used? You said a sales document but it sounds like you're writing instructions. Will your readers be trying to take actions based on the documentation, or is the purpose to give them information so they can decide whether to buy your product?
Feb
3
comment How should I handle repeating parts in a technical description?
This is how I would approach it as technical documentation, too. I'm not sure how the sales aspect figures in, though. We need to know more about how this will be used.
Jan
23
revised What is the best way to cite an anonymous writer?
removed promotional content (which, contrary to the claim, was not a reference for this information)
Jan
21
reviewed Approve suggested edit on tinyURL seen as risky by readers?
Jan
16
asked How can we make compiling release notes less chaotic?
Jan
16
answered What are the tool choices for producing technical documentation in PDF and web site ready HTML?
Jan
15
comment Is there a great manual for technical and scientific writing?
This seems quite broad to me. There isn't just one book that will tell you everything you need to know about scientific and academic writing, just like there isn't one that will tell you everything you need to know about writing fiction. I recommend asking more-specific questions (what do you want to know from that book you seek?), which we'll be better able to help you with.
Jan
15
comment Can Google Docs be used for technical product documentation?
@Mr.ShinyandNew安宇 yeah, it would be getting a little afield of the question -- hence my decision to comment, not suggest an edit. :-)
Jan
15
comment What non-WYSIWYG, non-proprietary alternatives to (La)TeX exist for the humanities, journalism, and other non-technical disciplines?
It was the back-and-forth about Microsoft and what is or isn't good/evil/proprietary/intelligent/capitalistic/etc. I kept the comments that contained helpful info (see the first two).
Jan
14
comment Can Google Docs be used for technical product documentation?
Seconded re using your version-control system. This also means that when you branch or tag the code for specific releases, patches, or other efforts, your docs will go alongside the code, helping to keep it clear to all what goes with what.
Jan
14
comment What non-WYSIWYG, non-proprietary alternatives to (La)TeX exist for the humanities, journalism, and other non-technical disciplines?
Comments removed: The purpose of comments is to seek clarification to improve the post. Extended discussions, arguments, and rants are not appropriate.
Jan
14
revised What non-WYSIWYG, non-proprietary alternatives to (La)TeX exist for the humanities, journalism, and other non-technical disciplines?
focused (per clarifications) and removed some non-constructive parts
Jan
13
answered Using emails in an autobiography
Jan
12
revised What is a reasonable amount of time to spend writing a product overview?
minor clarifications
Jan
12
answered What is a reasonable amount of time to spend writing a product overview?
Jan
12
reviewed No Action Needed How to create a document with a table of contents in Scrivener on Windows?
Jan
12
reviewed Reviewed What is a reasonable amount of time to spend writing a product overview?