<?xml version="1.0" encoding="UTF-8"?>
<!-- $Id: rating-anno-fields-en-us.xml,v 1.4 2006/09/21 20:25:17 ginger Exp $ -->
<metadataFieldInfo xmlns="http://www.dlese.org/Metadata/fields" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.dlese.org/Metadata/fields http://www.dlese.org/Metadata/fields/annotation/1.0.00/rating.xsd">
	<field name="Rating" language="en-us" metaFormat="dlese_anno" metaVersion="1.0.00" path="/annotationRecord/annotation/content/rating">
		<definition>a specific judgment about a resource that is defined by a collection</definition>

		<vocabLevels number="1">
			<levelAndDeftn level="1" levelName="Rating" levelDeftn="a specific judgment about a resource that is defined by a collection"/>
		</vocabLevels>
		<terms>
			<termAndDeftn vocab="One star">definition is collection specific and provided by the collection builder</termAndDeftn>
			<termAndDeftn vocab="Two star">definition is collection specific and provided by the collection builder</termAndDeftn>
			<termAndDeftn vocab="Three star">definition is collection specific and provided by the collection builder</termAndDeftn>
			<termAndDeftn vocab="Four star">definition is collection specific and provided by the collection builder</termAndDeftn>
			<termAndDeftn vocab="Five star">definition is collection specific and provided by the collection builder</termAndDeftn>
	</terms>

		<bestPractices>
			<dos>
				<practice status="current" originDate="2006-02-16" link1="ratings use in annotations" url1="http://www.dlese.org/Metadata/documents/how-tos/ratings.htm">Use this field only if the collection has defined the meaning of the controlled vocabulary. See ratings use in annotations.</practice>
				<practice status="current" originDate="2006-02-16" link1="One star" style1="bold" link2="Five star" style2="bold">The term One star is always lower/worse than the term Five star.</practice>
				<practice status="current" originDate="2005-10-05">Choose a single rating from the term list.</practice>
				<practice status="current" originDate="2006-02-16">Use rating to indicate meaningful information like how a resource performs in terms of usability, content, pedagogy and relevance.</practice>
			</dos>
		</bestPractices>

		<documentation>
			<obligation>choice</obligation>
			<min>1 or 0</min>
			<max>1</max>
			<XMLdataTypes>
				<XMLdataType>string</XMLdataType>
			</XMLdataTypes>
			<domain>controlled vocabulary</domain>
			<example>One star, Two star</example>
		</documentation>
	</field>
</metadataFieldInfo>
<!--	*** LICENSE INFORMATION *****
		Copyright 2002, 2003, 2004, 2005 DLESE Program Center
		University Corporation for Atmospheric Research (UCAR)
		P.O. Box 3000, Boulder, CO 80307, United States of America
		email: support@dlese.org. 
These XML instance documents are free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.  These XML instance documents are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this project; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->

