2,272 reputation
522
bio website cellio.livejournal.com
location Pittsburgh PA
age
visits member for 2 years
seen 22 hours ago
stats profile views 83

Feb
12
awarded  Nice Answer
Feb
10
comment LaTex vs. Word vs. etc
It's possible to automatically transform other formats to Word. (Of course, you have to write some XSL or Perl or a stylesheet or something.) I know of cases of DocBook -> Word, for what that's worth.
Feb
10
revised LaTex vs. Word vs. etc
small but important typo
Feb
9
comment How do co-authors' rights to a manuscript work?
I wouldn't assume there's a universal answer to that. Spelling it out covers all bases ("my interests in (work) go to (co-author)").
Feb
9
comment How do you track dependencies for your co-authors?
Thank you. We're already using source control (Perforce). If I change code and miss a related change, that might be caught by the compiler, the unit tests, or the regression suite, so there's a safety net. If I change some documentation and miss another document that depends on that, nothing will catch that (before, maybe, the end user). The best approach we've been able to think of when "just fix it everywhere" doesn't work is "record it somewhere", but the devil is in the details, as they say. I'll check out Unfuddle.com; thanks.
Feb
9
comment How do co-authors' rights to a manuscript work?
My lawyer advised me to specifically account for my intellectual property in my will to avoid that last problem. This is an area that is almost certain to vary by jurisdiction, so it's not safe to rely on defaults. Spell it out.
Feb
9
comment How do you avoid the problem of a collaborative work having separate voices?
Great question!
Feb
9
answered How do you avoid the problem of a collaborative work having separate voices?
Feb
8
comment How do you track dependencies for your co-authors?
We're actually already using version control, but haven't found a way to use it to indicate "this changed so this other thing may need to be updated". Maybe the answer is a project-management tool; are any of those suitable for many small tasks? The ones I've seen (not many) seem to be tuned for coarser-grained tasks, like "implement this feature (3 weeks)".
Feb
8
revised How do you track dependencies for your co-authors?
added clarification (based on an answer)
Feb
8
comment How do you track dependencies for your co-authors?
Thanks. I apparently wasn't clear enough (sorry!). I'm not talking about a case where I make a change and I go and update all the affected places ("call sites"); I'm talking about the case where I make a change and that means co-authors need to go look at their parts to figure out what they need to do about it.
Feb
8
comment How do you track dependencies for your co-authors?
I tagged this technical-writing because that's both my context and because I have the impression that this doesn't come up as much in other domains, but if anybody feels this should be more general, feel free to change that.
Feb
8
asked How do you track dependencies for your co-authors?
Feb
2
answered LaTex vs. Word vs. etc
Jan
30
comment Do You Use Any Version Controlling Software/Methods As Writers?
The only way I've found to get meaningful diff and merge is to write the text source myself, whether that's some XML flavor, HTML, LaTeX, or whatever. Sure, modern tools (and even Word :-) ) have a notion of exporting as XML, but each export will be its own thing with fresh line wrap and stuff, so if you rewrote one sentence the whole paragraph will probably show as a "something changed here" blob, which isn't very helpful. I write all my source in a text editor that won't try to "prettify" or format/export for me, and I can merge and review diffs easily.
Jan
30
comment Best text procesor— keyboard focussed UI
For my blog posts I use emacs and type the HTML tags by hand. (There aren't that many.) But full disclosure: for my technical writing I use emacs and type the Docbook XML tags by hand, too. I really hate tools that make me stop typing to use the mouse and menus.
Jan
27
answered How can I revise these sentences to be more correct while still keeping the effect?
Jan
24
comment Is it frustrating not to know the narrator's gender?
+1. As a reader I don't care if the author doesn't (it usually doesn't matter), but if it does matter, don't surprise me unless that's an intentional twist in the story.
Jan
19
comment How to write about things which depend on each other
@Kris, if you have to do this for both topics, one of them is going to be a forward reference. This works if that one-sentence explanation is enough to get you past the hurdle -- "ok, I'm going to have to write something called a callback; I'll get to that later. Meanwhile, to set up this subscription in the first place I need to (blah blah blah)."
Jan
17
answered How to write about things which depend on each other