Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »

Posts by Monica Cellio‭

318 posts
60%
+1 −0
Q&A Is a QR card linked to the PDF of a book a good idea?

PDFs use a fixed layout that doesn't scale with the device or window size, so they're not as friendly for smaller screens. Some people do read PDFs on some phones, though -- some screens are prett...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How do I show a long amount of time has passed?

One way to show passage of time is by referring to time-based events. Over the course of a year you can use seasons for this; if we see your characters walking through the snow, and next see them ...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Tool to batch convert DOI to citations?

I haven't tested this (which would require registering with them and obtaining an ID), but CrossRef provides a web service that appears to do what you need. From the documentation: Crossref qu...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A What word processor is recommended for writing a technical (programming) book?

You haven't specified any preferences for format (source or output), and that's going to be relevant. If it's up to you, for your source I recommend a text (not binary-format) markup language -- H...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Is it acceptable to ask a question in an argumentative paper?

This is a rhetorical question and, used well, can enhance the essay. The key to using this device is to first raise a question, issue, or concern that the reader might reasonably have, and then to...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
71%
+3 −0
Q&A How I should handle gender-neutral pronouns in technical writing?

Using "he/she" will annoy some of your readers; using singular "they" will annoy others. And referring to a user as "it" will seem weird to most people. What I do is to write around the problem wh...

posted 8y ago by Monica Cellio‭  ·  edited 4y ago by Monica Cellio‭

Answer
60%
+1 −0
Q&A Two perspectives in a non-fiction book

One approach is to write separate chapters (maybe alternating, but maybe in this case more from her?) with the writer identified at the beginning of each. A similar approach was taken in the Jumpe...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Maintaining readers over time with serialized fiction?

I am one of several authors on a fairly new shared blog. The blog has a mix of serialized and one-shot posts. Because it's a new blog (2.5 months, ~30 posts so far), there is quite a variety of p...

0 answers  ·  posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

50%
+0 −0
Q&A Is it necessary to explain what is written in upcoming chapters?

First, if your institution has a style guide, follow its recommendations if there are any. But assuming it is silent on this point or you don't have one: It's helpful to provide an outline of the...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
60%
+1 −0
Q&A Should I put diagrams into a formal essay?

There are a few relevant factors: Use diagrams when they add value I see plenty of formal writing that includes diagrams -- technical flow diagrams, trend graphs, timelines, resource-allocation c...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How can I convey something without going into details?

You can imply rather than say things with descriptions. For example: He picked his way down the garbage-strewn street, stepping aside to yield to an over-sized rat. The reek of stale beer and...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Format keyboard keys in documents

I am assuming that your organization does not have an official style guide, or that this is a personal project. (If you are bound by a style guide, consult it.) I am also assuming that you aren't...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How long is too long for a blog post?

A longer post can work on a blog that usually tends toward shorter posts if you take some care in structuring it. "Here are 20,000 words, plus equations" may send some people to the "back" button ...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
60%
+1 −0
Q&A How to cite nonpersonal email

"Private" doesn't mean just one recipient; it just means "not public". When you throw a by-invitation party in your home it's a private affair even if there are 50 people there. Email is the same...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
60%
+1 −0
Q&A How to work on a new software feature that affects different topics

It depends, but probably you want the distributed approach where the chapter on X tells you everything you need to know about X, even if some of that is only relevant if you're using feature Y. Ho...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How do I get rid of the tic of paired adjectives, predicates, etc.?

When I'm editing technical documentation (and, ideally, when I'm writing it in the first place), I try to make every word earn its place. If both words in your phrases need to be there to make you...

posted 8y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A What do I put on my copyright page when self-publishing?

If you're self-publishing and not doing it through a company, use your real name: "Copyright (C) 2015 John Doe". Under the Berne Convention (which applies in most countries), you own the copyright...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A When Dialogue is used for more than one character?

No. All that is required is that the reader know who is speaking. The conventions of dialogue do a good job of that. Bob continued, "blah blah blah." "But wait", Sue asked, "what about b...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Which citation style do I use if I'm writing a religious book?

Consider how your reader will use the book. In an academic work (which this is not), readers: are likely to already be familiar with the cited works (they're also researchers in this field, af...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A I have three dead-end chapters. Should I keep them or remove them?

While there might be a payoff coming in the fourth chapter, if readers get frustrated enough on the way there, some of them will bail and never finish your book. So while you can ask your reviewer...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How could collaborative writing in one world work?

A supplement to this answer: All the shared-world anthologies I've read had "framing" stories written by the primary author, the one who came up with most of the setting and is driving the proces...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A How to create a functional document for in-house reference?

In many ways you approach this the same way you would approach any other new project: Review any available high-level descriptions (like functional specifications) and user stories: what is this ...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
60%
+1 −0
Q&A Technical writer degree with an English BA?

Why not test the hypothesis, starting with the negative test? You are unhappy in your current career. You have some background but nothing official. A BA in English might or might not be a meani...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
60%
+1 −0
Q&A Ethics of incorporating a supplier's technical documentation into one's own documentation?

I am not a lawyer and this is not legal advice. First, check any license terms that accompany Company S's documentation. They might have published it with the intention that other vendors will in...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer
50%
+0 −0
Q&A Who do I cite as my source?

You cite the (or a) source that you used. If you read it in Book A and that book says it came from Book B, you cite Book A because that's your source. If you choose to follow the reference and se...

posted 9y ago by Monica Cellio‭  ·  last activity 4y ago by System‭

Answer