Jay wrote:
unnamednewbie13 wrote:
FEOS wrote:
Technical writers quite often do a horrible job of explaining their thoughts in clear terms. That's why classes on technical writing exist--to help scientists who often pay no attention to the rules or aesthetics of a language get their points across.
If technical writers do a horrible job of explaining their thoughts in clear terms because of flow, they're not very good technical writers. If it's a matter of vocabulary, that's the reader's fault.
Technical writing also has more applications than documenting science.
I do agree that vocabulary issues can be laid at the readers feet, but that doesn't mean that writers need to throw every million dollar word they know into every sentence in an effort to impress. It's exhausting reading that crap. It's especially exhausting when they continuously reuse the same word. I got a near perfect verbal score on my SATs and consider myself to have an extensive vocabulary, but if I have to read your work with a dictionary at my elbow just because you think running to a thesaurus every third sentence makes you sound more intelligent, you are a failure as a writer.
On the other hand, in the fields I have most experience with, certain words have a very strict and specific meaning with very little ambiguity or potential for overlap. So the jargon there really is necessary, otherwise you're obfuscating the material to make it more "digestible" which actually has the exact opposite effect. Jargon is not the problem here. The best quantum mechanics and EM textbooks I know - both by Griffiths - have complete and full technical detail
but are written in an eminently readable, lucid way. The result: it's easy to understand!
But as an example, from the section I'm trying to get through now:
Therefore, instead of considering one big field, we shall from now on restrict our attention to fields that destroy only a single type of particle (dropping the label n) and create only the corresponding antiparticle, and that transform irreducibly under the Lorentz group (which as mentioned above may or may not be supposed to include space inversion), with the understanding that, in general, we shall have to consider many different such fields, some perhaps formed as the derivatives of other fields.
That is an obscenely complicated way of putting across what are several fairly basic ideas.
Last edited by Spark (2012-11-04 19:36:22)