Archive for the 'Writing' Category

XML/DITA Weekend

Sunday, September 30th, 2007

UK Chapter of STC. 10/11 November 2007, Manchester, England. Details on the STC Forum: http://stcforum.org/viewtopic.php?pid=4163#p4163

Simplified Technical English and Plain Language

Monday, August 7th, 2006

This information was assembled by Global Talk from posts on the International Technical Communication SIG email list in April, 2006 and from additional research.

ASD Simplified Technical English is a specification developed by a committee that has an official website. This is a project of the AeroSpace and Defence Industries Association of Europe. There are two specific articles available, explaining the types of software that can be used in writing Simplified Technical English and training to write in STE(more…)

Latin abbreviations in technical documentation?

Monday, August 7th, 2006

This information is summarized by Global Talk from posts on the International Technical Communication SIG email list in April, 2006.

Abbreviations in the Latin language are often found in formal written English, and are required by some style guides. These abbreviations include:

  • e.g. (exempla gratia, for example)
  • i.e. (id est, that is)
  • etc. (et cetera, and so on — literally, “and others”)
  • n.b. (nota bene, note well).

The consensus on the International Technical Communication SIG list was that these Latin abbreviations have no place in technical documentation. We can not require readers whose first language is Arabic or Mandarin, for example, to know Latin. In fact the abbreviations i.e. and e.g. are often misused, suggesting native speakers of English do not understand them.

ITC SIG list members provided several references supporting their advice to avoid Latin abbreviations in technical documentation. (more…)

Use of the word ‘the’

Monday, August 7th, 2006

by Dhanya Menon, Technical Writer in Hyderabad, India with additions by Global Talk

The query (on the ITC SIG list) about omission of definite article ‘the’ interested me as I had been reading about the same a couple of days ago. According to High School English Composition and Grammar by Wren and Martin (which is considered an authority in India), in the following situations one must avoid usage of articles: (more…)

UK versus US spellings

Monday, August 7th, 2006

Global Talk is publishing this information from an ITC SIG list post in June, 2006.

Longman Dictionary of Contemporary English Online
is a British dictionary that specifics US and British spelling for words where the spelling varies.