Each component in HOMS will be presented in the HOMS Reference Manual (HRM) by a two page description. This description will be the first contact that users have with the component. Their decision as to whether or not they could make use of the component will be made on the basis of this description. Therefore, the description should aim at giving a comprehensive idea of the capabilities of the component and the conditions required for its use. Descriptions may be written in English, French, Russian or Spanish. The descriptions will be translated into English for initial publication and normally be edited before being included in the HRM. The HRM is published in printed form, on the Internet and on diskette and authors should bear in mind the capabilities and limitations of these different forms when writing descriptions. In particular, they should avoid the use of graphical figures or complex equations.
Only the two page description will be published. If necessary, additional information that is referred to in the description may be made available on request from the author.
Each component has a title about ten words long. The title is used for computerized search and query procedures and should therefore be as informative as possible. Acronyms should be avoided, unless these are well known, or are given in full in the title.
Each component will be assigned a reference number based on the classification system. Authors are asked to advise on the classification.
The description must contain the following ten sections, with the exception that Sections 3 and 4 may not always be needed:
1. Purpose and objectives
This section should state the problem or task the component is intended to solve. It should be brief. Usually two or three sentences will be sufficient.
This section should contain, in as much detail as possible, a description of the facilities offered and the methods used. Specific benefits of using this component should be mentioned. References to books and publications may be made, but the description should be complete in itself. This section is usually the longest in the component description. Following are some ideas on what to include under certain categories:
TECHNICAL MANUALS and GUIDES:
This section may not be needed for instruments, manuals and catalogues. It should describe the physical processes or data required for operating the component and their nature/format. State here also, if the output of another HOMS component is used as input to this component.
This section may not be needed for manuals and catalogues. The conceptual or physical product should be described here. State if the output is used as input to another HOMS component.
5. Operational requirements and restrictions
The following requirements should be covered where applicable:
6. Form of presentation
This should describe precisely what the component consists of. For example, is the component a computer program, a manual, or an instrument? Give the language of any printed documents and computer program messages, the programming language of the computer programs, specification of format and media for the data/software.
7. Operational experience
This section should describe actual operational experience gained using the component. Describe where it was used, giving the countries and environmental conditions. State briefly how successful it was. If an earlier or similar version of the technology contained in this component was available as a HOMS component in the past, this should be mentioned here.
8. Originator and technical support
Give appropriate credit to the originator (individual, agency, corporation) of the component. Technical support: Who will answer technical questions and possibly solve problems with the component? If training opportunities are available, they should be stated here. Also, if no technical support is available, this should be stated explicitly here. However, unsupported components will in general not be included in HOMS.
An indication must be given as to where the component and any additional information may be obtained, with full address and communication details.
10. Conditions on use
This section should cover financial and legal (including copyright) conditions - not technical conditions, these are covered under Section 5. It is hoped that components will be made available without charge, or for production costs only. If a charge is to be made for a component, the approximate amount must be stated here.
©2017 World Meteorological Organization, 7bis, avenue de la Paix, CP No. 2300, CH-1211 Geneva 2, Switzerland - Tel.: +41(0)22 730 81 11 - Fax: +41(0)22 730 81 81