Activity for Monica Cellio
| Type | On... | Excerpt | Status | Date |
|---|---|---|---|---|
| Answer | — |
A: How can I turn my short story into a novel? While it's possible to expand a short story into a novel (c.f. Ender's Game), what seems more common in my experience (citation needed) is for the short story to become one part of a larger novel. Your short story is already a self-contained unit; what else is going on around those characters, in tha... (more) |
— | over 9 years ago |
| Answer | — |
A: Is it necessary to add a.m./p.m. after the time? If it's important enough to mention the hour then it's important enough to be clear which one you mean, but using "AM" and "PM" in fiction may not be the best way. If the scene already makes it clear which one is being talked about -- on the beach you talk about the sunlight dancing off the waves, fo... (more) |
— | over 9 years ago |
| Answer | — |
A: Tools for multiple creators/writers documentation without clouds The main challenge of having multiple writers is dealing with conflicts -- either you have to lock files to prevent concurrent edits (as Word does), or you need a way to compare and merge changes. Locking files can be pretty limiting (especially as your group grows), but source-control systems give y... (more) |
— | over 9 years ago |
| Answer | — |
A: Why one sentence per paragraph in these news articles? There are two reasons. First, as described in this answer, news articles are written as an inverted pyramid and are designed to be cut at any paragraph break and still work. In the late stages of newspaper assembly, the editor making the decisions about what goes where and making it all fit is not go... (more) |
— | over 9 years ago |
| Answer | — |
A: Is it legal to share an index you made from someone else's book? > has anyone seen a similar situation which helps shed light on this grey area? I have in front of me two publications: Common LISP: The Language, by Guy Steele (et al.) and published by Digital Press, and Common LISP: The Index, by Rosemary Simpson and published by Coral Software Corp and Franz Inc... (more) |
— | over 9 years ago |
| Answer | — |
A: Acknowledgements in translated editions In books that go through multiple editions, you will sometimes see "preface to the first edition", "preface to the second edition", etc. In other words, there is precedent for not editing it out but instead adding to it, even if -- for all we know -- the stuff people helped with in the first edition ... (more) |
— | over 9 years ago |
| Question | — |
In Flare, how can we make atomic change groups in review? My team uses MadCap Flare for documentation and we have an editor on the team. When a writer is ready, we assemble a review package in Flare and send it to the editor, and she makes changes and sends it back to the writer for resolution. (The writer has the final say, and responsibility for making su... (more) |
— | over 9 years ago |
| Answer | — |
A: Cheapest way to self-bind a large book When I self-published a book some years ago I had the copy shop apply comb bindings for me. At the time this cost about $1/book, but it appears that Stapes and Office Depot now charge closer to $3 for this. If your print run is small, or if you are truly willing to trade time for expense, you can bu... (more) |
— | over 9 years ago |
| Answer | — |
A: How to describe a scene involving a shift in the environment due to forbidden magic? I can't call specific examples to mind right now, but I've seen this sort of "wait, the world is not quite as it should be" situation handled by sharing the POV character's inner dialogue as he gradually notices peculiarities. Something like this: > "Sharon, no!" he shouted to no one in particular a... (more) |
— | over 9 years ago |
| Answer | — |
A: Alternate universe vs. historicity: how to set the threshold/expectations? You first described it as "set in the late 1920s", and then later said you were "writing pseudo-historically in an alternate universe". I'm not bringing this up to nit-pick your question but, rather, to point out that these are two different things. There is historical fiction, where authors try to r... (more) |
— | over 9 years ago |
| Answer | — |
A: How do I cite or give credit to a statistic on a website? The APA style recommends the following for citing anything from web sites (which would include any claim you're reporting from one): > New child vaccine gets funding boost. (2001). Retrieved March 21, 2001, from http://news.ninemsn.com.au/health/story\13178.asp > > Cite in text the first few words ... (more) |
— | almost 10 years ago |
| Question | — |
How should I document a database schema? I am going to be writing some user-facing documentation for a database that visitors can query. That is, the people writing queries are not the ones who created the database; they can come in, look at what the database offers, and write their SQL queries. Think of something like SEDE. I could just... (more) |
— | almost 10 years ago |
| Answer | — |
A: How do I approach rewriting an entire user guide in an agile environment? I've written manuals under a Scrum process, so I'll describe what worked for my team. I'm going to treat your task as if you're writing a new book. From your description, you'd be replacing the vast majority of the content anyway, so better to think of it as a new book (for which you might be able... (more) |
— | almost 10 years ago |
| Answer | — |
A: Is there a standard for what should be included in an index? What goes into your index will be defined by your readers' needs. How will they use your book? Will they come in with knowledge of (and vocabulary from) a related subject? Are they experts or novices or some of each? An index's primary job is to have an answer when somebody comes to it with a questio... (more) |
— | almost 10 years ago |
| Answer | — |
A: Pros and cons of using real brand/company names? The main con is fear of corporate lawyers if they think you're portraying them negatively. I am not a lawyer (nor a writer or publisher of fiction), but my impression as a reader is that minor mentions don't provoke their wrath but if your plot hinges on, say, a horribly-malfunctioning vehicle, you m... (more) |
— | almost 10 years ago |
| Answer | — |
A: Choosing between your Mother Tongue and another language This depends in part on who your audience is, as already noted. It also depends on what kind of editorial support you'll have and on what your goals are. I've seen lots of work, both drafts and published work, by native speakers that doesn't really measure up. English is a difficult language full of... (more) |
— | almost 10 years ago |
| Answer | — |
A: Best Tool to Create User Guides For internal documentation I've found wikis to be quite useful. A wiki has several useful features for this task: - built-in change-tracking - doc can be structured as several pages (e.g. one per major section) for easier management; individual pages can then be edited without any need to merge chan... (more) |
— | almost 10 years ago |
| Answer | — |
A: How do you visualize plot structure? This XKCD strip shows a visualization approach for tracking character interactions -- who's with whom when. It works pretty well even with a complex plot with many characters (one of the examples is Lord of the Rings). While I haven't tried this myself, in your shoes I would try a similar approach, ... (more) |
— | almost 10 years ago |
| Answer | — |
A: How does one avoid incomplete changes to documentation? This is a hard problem. Unless your company has the resources to do full reviews of all the documentation on each release -- and if they do, I wonder how they stay competitive -- then you are at risk here. In my experience you can do some things to address the problem when it happens, and some things... (more) |
— | about 10 years ago |
| Answer | — |
A: How to reference a figure from text in a technical document In the absence of a style guide saying otherwise, your approach is fine. (So is abbreviating to "Fig.", though I prefer to spend the extra three letters and use the full word. It's also consistent with "Table", which I haven't seen abbreviated as "Tab.".) Whatever you do, be consistent -- refer to a... (more) |
— | about 10 years ago |
| Answer | — |
A: Stardate(Julian Day) - Problem As we've seen on earth, communities count time in reference to key events -- the creation of the world, the birth of a new religious figure, the beginning of a king's reign (these ones have less staying power), and so on. When calendar systems encounter each other (I say the year is 5774; you say it'... (more) |
— | about 10 years ago |
| Answer | — |
A: I need advice regarding the use of real-world locations in a novel This depends in part on how recognizable the landmark is to readers. On the one hand, if your scene is set in Times Square, it's hard to change anything -- enough people know the place that if you do, it'll just draw attention to your changes (which may be distracting). On the other hand, if your sce... (more) |
— | about 10 years ago |
| Answer | — |
A: How can I write better code-based reference documentation for programming interfaces? Start with the style guidelines from Oracle for Javadoc. While those guidelines are written for the Javadoc tool (and the Java language) in particular, the principles there apply to the corresponding tools for other languages. (I've seen this kind of documentation for C++, C#, and JavaScript APIs.) T... (more) |
— | about 10 years ago |
| Question | — |
How can I write better code-based reference documentation for programming interfaces? Programmers can write comments in code that can be automatically turned into API documentation (like Javadoc). All I have to do is add some comments explaining what a class or method does and what arguments it takes, and software turns those comments and the signatures from the code into reference do... (more) |
— | about 10 years ago |
| Answer | — |
A: Writing an article avoiding Libel There is no way to absolutely prevent lawsuits; if you're going to cover controversial topics and name names, there's a risk that people will get upset and seek to take action. But there are some things you can do to "write defensively", so to speak. Following are some things I was taught in college ... (more) |
— | about 10 years ago |
| Answer | — |
A: Published on blog but taken down: Still remains previously-published? Would it count as "previously published" if it appeared in your (print) newspaper, but it was three years ago and nobody is likely to still have old copies lying around? This seems like an analogous case. Your blog post, if it was at any time public, probably is still out there, in the Wayback Machi... (more) |
— | about 10 years ago |
| Answer | — |
A: What is the purpose of version control? If you are one of those rare people who can write, straight through, without any major refactorings or changes of direction along the way, more power to you. But for many people, and IMO any long-running project, source control is a major benefit. Here are some of the reasons: - When you realize the... (more) |
— | about 10 years ago |
| Answer | — |
A: Present tense in user manuals Let's break down your illustrative sentence: > Users can delete Servers This statement describes a capability -- users can perform this action. I'm hard-pressed to imagine how a different tense could be used here. Some technical writers (or style guides) make this overly passive -- "the system supp... (more) |
— | about 10 years ago |
| Answer | — |
A: How do I claim the number of scholarly articles on a niche subject is relatively small without listing every single one of those citations? Consider something like the following: > ... has only been thoroughly evaluated by a small number of experts in the xx literature, the most significant of which are (author1992, author1994, ...). By casting it this way you're not implying that you're listing all of them but you're also not just pic... (more) |
— | about 10 years ago |
| Answer | — |
A: "Where did X go?" vs "where had X gone." Both phrasings refer to an action that occurred in the past (his going). The additional nuance you need to consider here is whether the question itself sounds like it occurred in the past. A question that is part of the narrative should sound like a past question, just like the other events you repor... (more) |
— | about 10 years ago |
| Answer | — |
A: Marking a chart that is not based on real data I've seen this done with a "watermark" that says (usually) "sample data" (kind of like this, from here, though that's a table rather than a chart). Think of the "draft" watermark you sometimes see on documents; same idea. Saying something in the text (or figure caption) can be helpful, but this appro... (more) |
— | over 10 years ago |
| Question | — |
How can we make compiling release notes less chaotic? Each of our software releases is accompanied by a set of release notes, which include short descriptions of the following: new features, important or breaking changes to old features, and important bug fixes. New features are pretty easy; people know what's happening there. Our challenge is with the ... (more) |
— | over 10 years ago |
| Answer | — |
A: What are the tool choices for producing technical documentation in PDF and web site ready HTML? Here's what we do for that. It's not cloud-based, but it is source-control-backed, like (I hope) your code already is. Tools and technologies involved: - source control - DocBook DTD - your favorite editor for XML files (WYSIWYG possible) - XSLTProc (with ant, but you could do make or something ... (more) |
— | over 10 years ago |
| Answer | — |
A: Using emails in an autobiography For what you need to do legally, you'll need to consult a lawyer in your jurisdiction. Laws vary. The rest of this answer is about practical considerations. First, are you on good terms with the person whose email you want to use? Do you want to be on good terms after you publish your work? If so, t... (more) |
— | over 10 years ago |
| Answer | — |
A: What is a reasonable amount of time to spend writing a product overview? Ah, the "you can write in one context, so you must be an expert in writing in another context" fallacy. I've been on the receiving end of that too. Being a good academic writer, or engineering writer, or anything else doesn't mean you can automatically write good user-oriented material (or vice-versa... (more) |
— | over 10 years ago |
| Answer | — |
A: How to start a technical book? Since you're a software developer, I encourage you to think about the book the way you think about a significant application. You (probably) don't just start writing code; you do some requirements analysis, maybe some use-case analysis (please don't shatter my dreams :-) ), some high-level design... ... (more) |
— | over 10 years ago |
| Answer | — |
A: Can I plug a loophole in my magic rules without rewriting the whole novel? Consequences. That something is possible within a system doesn't mean it's a good idea. You can drive your car 180MPH on public roads (if the speedometer labeling is accurate), but if you do you'll soon be getting used to a bicycle. You can subsist on nothing but Big Macs and Coke for a year, but yo... (more) |
— | over 10 years ago |
| Answer | — |
A: Using capital letters for shouting Text in all capitals is harder to read than text in mixed case: > A 1955 study by Miles Tinker showed that “all-capital text retarded speed of reading from 9.5 to 19.0 per cent for the 5 and 10-minute time limits, and 13.9 per cent for the whole 20-minute period.” Tinker concluded that, “Obviously, ... (more) |
— | over 10 years ago |
| Answer | — |
A: How do I write for webcomics? A comic -- web or paper, cartoon strip or sophisticated graphic novel -- is a different medium from conventional written stories. The biggest difference is that it's hard to do exposition; those long explanatory passages that you could slip into a novel don't fit into a few panels. It's also hard to ... (more) |
— | over 10 years ago |
| Question | — |
How do I avoid tech/social errors in near-future fiction? Not long ago I read a novel set in the near future (mid-21st century). My suspension of disbelief was totally fine with time travel, an implanted "universal translator" of sorts, major medical advances... but balked at plot points that depended on people being limited to land-lines (no mobile communi... (more) |
— | over 10 years ago |
| Answer | — |
A: Is my serial-killer novel horror or crime? I agree with SF and Lauren that who your POV character is affects this. But I'll take a different approach in answering this: when you talk about your project socially (e.g. with friends/family), what do you tend to focus on? What's exciting about this to you? When you're not worried about making a g... (more) |
— | over 10 years ago |
| Answer | — |
A: How can I prevent, or work around, unfortunate hyphenation in critical words? With help from a coworker I was able to fix this by adding the following to the FO stylesheet: And likewise for other elements that should get this treatment, like `methodname` and `literal`. This creates a wrapper around the native style, changing hyphenation only... (more) |
— | over 10 years ago |
| Question | — |
How can I prevent, or work around, unfortunate hyphenation in critical words? In technical documentation, sometimes the tool's automatic hyphenation makes a bad break in the middle of a term, like the name of an environment variable or function. In these cases I would rather have a short line than hyphenation, though I want hyphenation in the document in general. I can try to ... (more) |
— | over 10 years ago |
| Answer | — |
A: becoming better blogger when I write about diverse topics In my experience there are two main types of blogs out there, topic-focused and person-focused. You're describing the latter. Person-focused blogs, which cover a range of topics and styles with the unifying theme of "interesting enough for the blog author to want to write about", seem to attract a s... (more) |
— | over 10 years ago |
| Answer | — |
A: Really Stuck: Writing Dialogue If your antagonist is living in the present time (but is 1000 years old), then is there any reason to believe that his speech hasn't evolved? Think about what happens to people when they move to a new place with language patterns different from the ones they grew up with; don't they tend to adapt? T... (more) |
— | over 10 years ago |
| Answer | — |
A: Punctuating Thoughts "Hard and fast rules" come from the style guide you're following; all else is convention. I've seen both styles in fiction, so to decide which to use you can look at examples of similar type (genre, length, etc) to see what they do. If you're submitting for publication, then the publisher might have... (more) |
— | over 10 years ago |
| Answer | — |
A: Background speech with foreground dialogue I saw an effective example of this in 1634: The Baltic War (David Weber & Eric Flint) recently. The factors that made it work were: - The background speech was in italics (as you've done here). - The passages of background speech began and ended in the middle of sentences. - There wasn't a lot of ... (more) |
— | over 10 years ago |
| Answer | — |
A: Describing common hand gestures In many cases you don't actually need, or necessarily want, to describe the gesture itself. It is often enough, or even preferable, to (a) convey that there was a gesture and (b) convey its meaning, without describing the gesture. There are at least two reasons for this: 1. The gesture is idiomatic ... (more) |
— | almost 11 years ago |
| Question | — |
API reference doc: best practices for describing opaque parameters? The reference documentation for an application programming interface (API) is, in modern systems, usually generated from the code itself automatically. For example, for Java interfaces a typical tool is Javadoc. One property of such generated documentation is that the code interfaces -- for example,... (more) |
— | almost 11 years ago |
| Answer | — |
A: Publishing price comparisons. Is it allowed? Buying guides, including reviews and prices, are not uncommon, with the quintessential example (at least in the US) being Consumer Reports, a monthly product-review magazine (with web site). Local laws may vary, of course. Since this is a "small localised list", perhaps there is a matter of etiquett... (more) |
— | almost 11 years ago |