Subject: [Tzdist] draft-ietf-tzdist-service 6. Actions

From: Tobias Conradi <[email-masked]>
Date: Sun, 21 Sep 2014 06:44:00 +0200

It seems that for all actions one "gets" some data, so all are "get"
actions and to name one as "get" and the others not, is inconsistent.

--------------------
6.1.  "capabilities" Action
Name:  capabilities
Description:  This action returns the capabilities of the server,
6.1.1.  Example: Get Capabilities

NEW
6.1.1.  Example: Get capabilities

--------------------------
6.2.  "list" Action
Name:  list
Description:  This action lists all time zone identifiers or the
      requested time zone identifiers
6.2.1.  Example: List time zone identifiers

NEW
Description:  This action returns a list of all time zone identifiers or the
      requested time zone identifiers
6.2.1.  Example: Get list of time zone identifiers

--------------------------
6.3.  "get" Action
Name:  get
Description:  This action returns a time zone.
6.3.1.  Example: Get time zone
6.3.2.  Example: Get time zone alias
6.3.3.  Example: Get truncated time zone

NEW
6.3.  "tzdata" Action
Name: tzdata
Description:  This action returns time zone data.
6.3.1.  Example: Get time zone data by tzid
6.3.2.  Example: Get time zone data by tzid-alias
6.3.3.  Example: Get truncated time zone data

----
6.4.  "expand" Action
Name:  expand
Description:  This action expands the specified time zone into a list
      of onset start date/time (in UTC) and UTC offsets.
6.4.1.  Example: Expanded JSON Data Format

This belongs to 6.3 as it returns time zone data and not only expands
it on the server.

NEW
6.3.4 Example: Get expanded time zone data
action=tzdata&expand(ed)=true

----------------------------

6.5.  "find" Action
Name:  find
Description:  This action allows a client to query the time zone data
      distribution service for a matching identifier
6.5.1.  Example: Find action

This action does not allow a client to query, but it returns data as
the other actions above.

The description does not say what is actually returned, so I have no
proposal for a name of that action.

If it returns a list of TZIDs, then it could belong to the list action
in section 6.2.

If it returns tzdata, then it could belong to section 6.3. In section
6.3. the returned tzdata varies, e.g. truncated, expanded, "normal",
so from the find example it looks as if the returned tzdata is a
further subset of all data of a time zone.

NEW, could be
6.5.1.  Example: Get time zone data by tzid pattern

-- 
Tobias Conradi
Rheinsberger Str. 18
10115 Berlin
Germany

http://tobiasconradi.com