/*
 * CHANGES
 * $Id: CHANGES,v 1.2 2000/08/08 17:02:03 gillies Exp $
 * CHANGES to the Phase 1 DTD and associated files are included here.
 */

/************************ 18 November 1998 KG ************************ */

Added and modified investigator invStatus to match NOAO's categories:
PhD/Doctorate; Graduate student, thesis; Graduate student, not thesis;
undergraduate; other.

Made <keywords> optional.  Some observatories may not use keywords.
Also this makes the minimal document simpler.  If <keywords> is 
present, there must be at least one.

Created minimal.xml document to so we always know what the smallest/empty
valid document looks like.  Created "minimal" test script.

Added an optional invVisiting flag to the pi and coi to indicate that
an observer will visit the observatory during the observing run.  The
element is empty.  Added this flag to the test document.

Add an option <support> item that can be first night, no or all nights
as options.

Renamed <extras> to <proposalSupport> and created a new item
called <requirements>.  Moved <travelNeeds> to <requirements>.
Requirements holds things the observatory must do for the observer.

Make observatory optional. An empty document doesn't include an
observatory.  GUI should use "add observatory" to add each one.
This allows a common part to be saved without an observatory.
A proposal without an observatory is probably not too useful but
might actually map to very simple observatories that just list
targets.

Added an option <staffSupport> item to <requirements> that can 
be firstNight, none, or everyNight as attribute "need".

Changed <grants> to <allocations> in <proposalSupport>, which
has four fields (allReference, allAward, allUseful, allComment)

Changed <obsResources> to <resources>.  Added an optional <resources> 
for entire obsList in <observatory>.  Made <resources> in <observation>
optional so observatories that don't use this feature (Gemini) won't
need to see it in the document. Added test in test.xml.

Change keywords+ to keywords* to support saving empty document.  Some
observatories won't use keywords.

Remove observatoryExtensions from Observatory.  All observatories
must manage their own "new data" since the common part really doesn't
care.  This removes one use of references, which isn't a bad thing.

Removed required ID from Gemini extensions and test extensions since
they are no longer needed.

Removed geminiNorth and geminiSouth entities and replaced with one since
north and south are facilities not observatories.  Fixed facility ID's
in GeminiData.xml

/************************ 8 Febrary 1999 KG,SW ************************ */

Removed ability to associate resources with individual observations.  Will
replace when users request it.

Removed resources completely.  Replacing resources in obsList with
resourceRef*.

Remove instrumentRef, facilityRef.

Added RTF to attachments.

Removed embedded text.  Couldn't figure out why we had it!

Added contact to investigators, removed some "inv" and tried to match
common words when possible.

Removed GeminiPart targetList

Added comment element to be shared by any other element needing a comment.

Added comment to syncObservingDates.

Changed allocation names to allocationReference, awardedTime, percentUsefulTime,and comment. Also added a text comment to allow explanation of the rest.

Changed preferred and impossible dates to optimal and acceptable to focus
on proposal scheduling needs, not observer personal needs.

Moved investigator status to pi as attribute according to the attribute/
content agreement.

Made yes/no visiting an attribute in pi and coi.

Added PCDATA for comment on staffSupport.

Broke out parts of the DTD into smaller modules which can be used elsewhere.
Investigators (pi, coi, site), resources, and targets are now in 
investigators.mod, resources.mod, and targets.mod, respectively.

Added justification element to proposal for shared scientific justification.
This can include embedded text or attachements.

requirements only appears in the observatory element now.  No common
requirements.  

Changed targetRef from targetRef+ to targetRef*.  It is possible to have
an observation without a target.  Why not?

/************************ 7 April 1999 KG,SW ************************ */

Removed items in proposal element into common element.

Removed scheduling and proposalSupport from common.  Common items are
no longer optional (other than keywords).

Added element submissionDetails to the AstronomyPhase1.dtd.  This element
contains items that must appear in an observatory data file allowing
the maintainer to indicate when the proposal period is and when the due
date is, etc.

/************************ 15 April 1999 KG,SW ************************ */
Added creation date to the common element.  Added creation and lastModified
attributes to the geminiPart and obs2Part (should be included in every
observatory).

Added submission URL info to the submissionDetails element.  Now an
observatory can give one or more fetch or submit URLs for use with their
native submission method.

Remodeled the xml namespace attributes for common and geminiPart to be more
like is recommended (i.e. a URI).

/************************ 20 April 1999 KG,SW ************************ */
Changed optimalDates to impossibleDates to more closely match UKIRT, etc.

/************************ 28 April 1999 KG,SW ************************ */
Removed date from impossibleDates, syncObservingDats, and optimalDates.

/************************ 29 April 1999 KG,SW ************************ */
Removed the concept of parts and added support for constraints and 
extensions into the observation via the wrapper elements extension and
constraint.

Moved namespace info to the root element. Added namespaces to extensions
and constraints.

Fixed various test and example files.

/************************ 2 May 1999 KG,SW ************************ */
Added "name" to constraints to support the removal of uniqueIDs from
phase 1model.

/************************ 22 May 1999 KG,SW ************************ */
Added nonSidSystem to provide a simple way to provide approximate positions
for non-sidereal objects on specific days.

Added institution to coi.  Institution is needed to make sure referees
are picked properly based on the institution of all team members. 

Moved created and lastModified to the only position in the phase1Document
element (out of common and observatory).

/************************ 25 May 1999 KG,SW ************************ */
Made nights the default for timeUnits.

/************************ 28 May 1999 KG,SW ************************ */
Changes to Gemini.dtd for new ObsConditions element replacing old
siteConditions.

/************************ 4 May 1999 KG,SW ************************ */
Made ResourceList an optional element within observatory. It was an
extension.

/************************ 21 June 1999 KG,SW ************************ */
Fixed the namespace parameters with //

/************************ 22 June 1999 KG,SW ************************ */
Added impossibleDates comment.

/************************ 15 July 1999 KG,SW ************************ */
Reworked comments.  Moved investigators.mod back into phase1 DTD just to
make things easier.  target.mod will continue to be external.  Removed
resources.mod at put it into Phase1Astronomy.dtd.  Created gemini
directory for Gemini tests.

/************************ 21 July 1999 KG,SW ************************ */
Added the element resourceOverheads for use in observatory data files.
This feature allows the expTime, expTotalTime feature to be used by
observatories.

/************************ 10 Sept 1999 KG,SW ************************ */
Added some details needed by Phil.  Added GeminiStaff to Gemini.dtd.

/************************ 5 Feb 2000 KG ************************ */
Fixed contact in AstronomyPhase1.dtd to allow any number of
email, fax, phone in any order.  Upped version to 1.13

/************************ 6 August 2000 KG/JW ************************ */
Added <targetBrightness> to a target element in target.mod.  The idea
is to allow some text to be added that describes the brightness of a
target in a way unique to the target's use.  Changed version to 1.14
in AstronomyPhase1.dtd even though it really didn't change.
