| bio | website | cellio.livejournal.com |
|---|---|---|
| location | Pittsburgh PA | |
| age | ||
| visits | member for | 2 years |
| seen | 4 hours ago | |
| stats | profile views | 83 |
|
May 25 |
answered | How well would this beginning sell the book to readers? Not necessarily for money |
|
May 17 |
awarded | Yearling |
|
May 11 |
answered | How can you write less to say more? |
|
Apr 25 |
comment |
How can I search for words by meaning/definition? I Googled "idiom for" plus the key part of your definition and the first link was "winnow". Phrases (as opposed to words) are often idioms, and (as you probably found) "definition" doesn't give good results, so maybe this pattern works more broadly? (I haven't tried other phrases.) |
|
Apr 17 |
answered | Should I put colons with second-level titles? |
|
Apr 17 |
comment |
Should I put colons with second-level titles? No need to apologize. Thanks; this is much clearer! |
|
Apr 17 |
comment |
Should I put colons with second-level titles? Could you give a real example, with some context? Does Title 2 immediately follow Title 1? (In that case sometimes title 1 gets a colon, but not 2.) |
|
Apr 12 |
comment |
A tricky serial semi-colon Perhaps the rules are different for serial subjects and serial objects. The reason your first case (with semicolons) bothers me si that we're getting a list before we even know why. Flip it around (like in the "he is survived..." case) and it reads quite naturally with semicolons. |
|
Apr 12 |
comment |
What would sections of a book that are larger than a chapter be called? I don't think "unit" in a tutorial would be out of place, but it would strike me as odd in a reference manual (something not designed to be read sequentially). But this could vary by domain, so it's best to see what others are doing with documents similar to yours. The people reading yours will probably have read theirs, after all, and that's a source of reader expectations. |
|
Apr 11 |
comment |
What would sections of a book that are larger than a chapter be called? I have the impression that technical writing that follows a public DTD (versus in-house conventions, document styles, etc) is still a minority, but anecdotally, within that set DocBook seems reasonably common. Another reference to chase is DITA, which is more of a framework but has a DTD or schema that people use, I believe. I think FrameMaker SGML had the same structure back when I was using it more than 10 years ago, but those memories are swapped out now. |
|
Apr 11 |
comment |
What would sections of a book that are larger than a chapter be called? In my experience "unit" is only used with training materials (or textbooks). |
|
Apr 11 |
comment |
What would sections of a book that are larger than a chapter be called? "Part" is what I'm used to. A section is smaller than a chapter. (As one bit of evidence, the DocBook DTD calls for part - chapter - section in that order.) |
|
Apr 7 |
awarded | Nice Question |
|
Apr 2 |
answered | Is it overkill to follow style-guides for technical writing? |
|
Mar 29 |
comment |
What is the best way to learn technical writing in English? I proposed migrating to Writers.SE when I voted to close. I don't know if an automatic migration is already in progress; if it doesn't show up there you might want to just re-ask it there. |
|
Mar 29 |
comment |
What is the best way to learn technical writing in English? This would probably get better answers over at Writers.SE. |
|
Mar 27 |
comment |
Where to find authors for highly technical articles? Programmers who have risen to a certain level have almost certainly written design docs. You can ask to see samples of those. |
|
Mar 27 |
comment |
Where to find authors for highly technical articles? While writers who can program are pretty rare, what I meant to say there is that they seem to be particularly rare in STC. I suspect that some gravitate to ACM or IEEE instead, and others (like me) just don't join professional associations (unless it's a side-effect of going to a conference). |
|
Mar 26 |
answered | Where to find authors for highly technical articles? |
|
Mar 23 |
comment |
Will my readers feel like they are reading a children's storybook if there are illustrations in my novel? I would expect the style of the art to make a big difference (cartoony vs representational, amount of detail, etc). |