Online groups, summer 2011

Graphic design

A member wants to improve her graphic design skills. She is specially interested in graphic design for technical manuals. What makes a graphic good instead of only average? What are the principles of graphic design?

Members recommended the following books:

Andrew Mundi has a good introduction to graphic design:

For resources and tutorials, a useful website is

Typography of symbols

What are the guidelines for the typography of scientific and technical symbols? For example, what is the usual letter space between a value and an abbreviation of a unit?

Tools for DITA

One member asked whether the DITA Open Toolkit is sufficient for structured writing (

To produce useful output with only the DITA Open Toolkit is difficult. Tools help you to obey the XML schema. Members suggested the following tools:

Many of the editors that support DITA include the DITA Open Toolkit. Therefore, you can create output 'out of the box'. If you can write script and have XSLT skills, then you can customize the DITA Open Toolkit.

The spelling of new nouns

In one search, Google gave 47 million results for 'touchscreen' and 118 million results for 'touch screen'. When a new noun is made from two words, what are the rules for spelling? For example, is the correct spelling 'touch screen', 'touch-screen', or 'touchscreen'? Another member bought a PC with a touch-sensitive screen. The US website used 'touchscreen', but the UK website used 'touch screen'.

Usually, first the words are not connected, then they have a hyphen, and finally, they become one word.

Technical communication must be clear. If the two existing words that make the compound noun each have many meanings, confusion is possible. Therefore, make sure that the new thing is clearly different from the two existing words. The words 'touch' and 'screen' are both verbs and nouns:

Confusion is possible, specially for people who do not use English as a first language. Technical communicators must minimize the possibility of confusion. Therefore, 'touchscreen' and 'touch-screen' are satisfactory, but 'touch screen' is not satisfactory.

CMSs for websites

To improve some old websites, a member wants to use a content management system (CMS) instead of HTML and CSS. He wants a flexible design, a good range of templates, and the option to change colours and backgrounds. Additionally, the CMS must be easy to learn and easy to use.

Members recommended the following CMSs:

One member uses Blogger to link two separate blogs to her website ( The member thinks that Blogger can be used for a template-based website. Blogger is easy to use, and has many templates.

A CMS is good if you manage and publish much content. However, a CMS can restrict options, and you need time to learn to use the CMS.


RSS feed