Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.forth > #28124

Re: [OT?] Would journalists be preffered documenters?

Show all headers | View raw

I guess journalists may learn how to do tech writing, but I don't
think that they would write good documentation without additional
training.  Even at a very low level, they learn the wrong skills:

E.g., we learned in school that in good literary style you do not
repeat words; instead, you use synonyms.  Journalists tend to follow
that rule to comic proportions, occasionally even using synonyms that
make their text (and, worse, the subject that they refer to)
ridiculous.  In tech writing this rule is a bad idea, because it tends
to confuse readers.

- anton
-- 
M. Anton Ertl  http://www.complang.tuwien.ac.at/anton/home.html
comp.lang.forth FAQs: http://www.complang.tuwien.ac.at/forth/faq/toc.html
     New standard: http://www.forth200x.org/forth200x.html
   EuroForth 2013: http://www.euroforth.org/ef13/

Back to comp.lang.forth | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[OT?] Would journalists be preffered documenters? Richard Owlett <rowlett@pcnetinc.com> - 2014-01-25 11:52 -0600
  Re: [OT?] Would journalists be preffered documenters? Paul E Bennett <Paul_E.Bennett@topmail.co.uk> - 2014-01-26 10:30 +0000
  Re: [OT?] Would journalists be preffered documenters? trebor.english@gmail.com - 2014-01-26 10:40 -0800
  Re: [OT?] Would journalists be preffered documenters? "Elizabeth D. Rather" <erather@forth.com> - 2014-01-26 12:47 -1000
  Re: [OT?] Would journalists be preffered documenters? anton@mips.complang.tuwien.ac.at (Anton Ertl) - 2014-01-27 14:51 +0000
  Re: [OT?] Would journalists be preffered documenters? Matthias Koch <matthias.koch@hot.uni-hannover.de> - 2014-01-28 10:40 +0100

csiph-web