Tips for SERF Writing
|1. Which fields should be completed?
All applicable fields for a given service should be completed. Some information may not be available or cannot be recovered, and some fields do not necessarily apply to every service. When the information cannot be obtained or would not make sense, the field should be omitted.
Some fields are required, meaning that the fields must be present in the SERF in order for the SERF to load into the SERF database. These fields are Entry ID, Entry Title, Science and Service Keywords, Service Provider, and Summary.
Other fields are deemed highly recommended, meaning these fields are crucially important for data service selection (i.e., searching), user understanding of the data service, or data service access. Fields highly recommended for user understanding of the data service are Distribution, Instrument, Platform and Project. Without these fields, users cannot know if a service is appropriate for their needs. There are other fields which are recommended, meaning these fields are important, but not crucial for searching. These fields are Ancillary Keyword, Multimedia Sample, Publications/References, Parent SERF, IDN Node, SERF Creation Date, Last SERF Revision Date, SERF Revision History and Future SERF Revision Date.
2. How should the service be aggregated?
A key question when writing a SERF is: What should be described in a single entry? In some cases, a group of services should be described by a single SERF. In other cases, related services may be grouped together even though they may be identifiable in smaller subsets, as in a catalog or inventory. Both situations indicate the SERF describes an aggregation of services. Your determination of the appropriate group of data to describe should be the primary guideline.
Some rules of thumb:
3. What constitutes a good title?
A good title is important because the user, when receiving the results of a metadata search, is often presented with a long list of similar titles. Titles should convey the content of the service(s) and should be descriptive enough so the user, at search time, can distinguish the content from other similar services. Generally, a good title may include parameters measured, source name, sensor name, project, or service provider center name.
4. Why do some fields require valid keywords?
Valid keywords (or valids) are important in allowing precise searching of metadata records. The use of valid keywords insures that SERFs are keyed in a consistent manner. Thus, users searching for entries will be able to retrieve all entries related to a particular criteria. In theory, a search on the term, aerosols, will return all entries about aerosol data. Therefore, it is very important for SERF authors to key SERFs with all appropriate valids in all applicable fields. SERF authors must be extremely familiar with the lists of valid keywords and understand the variety of words in the lists.
Furthermore, valid keywords are especially important to international users who may be unfamiliar with some English scientific terms. A browsable list of keywords will prompt the non-English speaker to select the most appropriate words when conducting a search.
The following fields require the use of valid keywords to aid users in searching for information: Service Keywords, Science Keywords,Instrument,Platform, Project, and Service Provider Name. In addition, the following fields require the use of valid keywords to insure proper maintenance and presentation of information: Service Language, Personnel Role, URL Content Type (in Related URL), and IDN Node.
Where there is a hierarchy of valids, as with Keywords, SERF authors should key SERFs to the most specific level possible. For example, it is far better to key the SERF with Reference Services > Bibliographic > Bibliographic Databases when applicable rather than Reference Services > Bibliographic. If users conduct searches with Bibliographic Databases, they will miss the SERF keyed with only Reference Services > Bibliographic.
5. What constitutes a good summary?
A good summary is descriptive. It describes the service so that users are able to decide whether the service is appropriate for their needs. For a list of possible service characteristics to include in the summary, see the Summary Checklist in the Summary section of the SERFGuide.
|This document should be cited as:
Service Entry Resource Format (SERF) Writer's Guide, 2013.
Global Change Master Directory.
National Aeronautics and Space Administration.