2012-02-06
Some practical information, which includes links to the ISO/IEC Directives, standards templates and other ISO documentation for writing standards.
See ISO/TC 19104:2008 and the latest version of the terminology spread sheet.
It is the responsibility of the leader/editor to make their internal UML models available for comment to the HMMG as soon as those models are in draft form. They should be an Enterprise Architect package built within a recent copy of the Harmonized Model (available at http://www.isotc211.org/hmmg/EArchitect/). An XMI export of that package should be e-mailed to the HMMG chair and copied to the secretariat. The purpose of this is to identify harmonization issues early so that they may be handled by the appropriate editing body (PT or EC).
According to Resolution 236 the project leaders'/editors' shall be members of the HMMG during the project period.
Terms of reference for the Editing Committees: N 2517
Guidelines for the Editing Committees: N 2518
See also information for project leaders/editors below.
This site is to help the project leaders and editors in their work.
Please visit the Standards development area of the ISO web site, which includes the Directives and all tools needed. There are several ways to go into the different places you need, for example:
Please note that
Aslo note that
The secretariat notes that there are certain items that keeps coming up in all drafts, and has therefore collected these in a check-list.
Please note that project leaders shall check the terminology to assure harmonization. The latest version of the terminology spreadsheet.
For harmonization with other ISO standards, note that ISO has now issued the "Concept Database", where all terms and definitions from all ISO standards is include.
For each project the member bodies nominate experts to work on the project. These experts forms the project team, which automatically becomes part of the WG to which the project is assigned. The project leader will receive a list of the appointed experts from the secretariat. Whenever a change is given from the member bodies to the secretariat, the project leader will be notified. Only experts appointed from the member bodies via the secretatiat shall be on the distribution list of the project leader. If the project leader receive information from someone that wants to participate in the work, he/she must ask this person to contact their member body for official nomination.
It is important that the project leader includes the whole project team in the work, also those that are not able to attend meetings. The whole team shall have the opportunity to comment on new versions before it proceeds to CD.
If you have any questions, please contact the secretariat.
This list is a collection of typical problems with the documents the secretariat receives. All are covered in the Directives and templates, and the link above to ISO is the site where you can find information. This list is just a supplement and reminder.
Download the reference manual and take a quick look before you start!
Remember that this is a template, all necessary styles are already included.
Exception:
Most of our standards have code lists, and a style for this may be added
Normative language
Check the use of normative statements, it shall be shall, or it shall be may.
Annexes
Annexes shall appear in the order they are sited in the document.
Paragraphs
Hanging paragraphs and stand alone paragraphs are not allowed.
Figures
Figures shall be in a reviseable format. Exceptions are photographs.
Do not use colours unless it is necessary for the understanding of the figure.
There shall not be text in the figures, use keys below the figure. Remember that the standards are translated into many languages. It shall not be necessary to redraw the figures. Exceptions here are the UML-models. Check out ISO's web site on preparartion and submission of graphics.
References
Grammar
Use complete sentences in the normal text! (Definitions are an exception with special rules.)
Other reminders
Be consequent in the use of capital letters; don't use it unless it has significance.
Remember that the typical reader of the standard has not been involved in the committee work!