diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md deleted file mode 100644 index 850ca52..0000000 --- a/ISSUE_TEMPLATE.md +++ /dev/null @@ -1,9 +0,0 @@ -Filing an issue about the **xAPI Profiles** specification? Please include the following - -- [ ] Which part/parts of the specification are at issue? - -- [ ] What is your understanding of what the spec means in these parts? - -- [ ] Related to your implementation, what's the use case you're trying to achieve? What are the user stories you're trying to support? - -- [ ] How you would like the specification to be improved? diff --git a/context/profile-context.jsonld b/context/profile-context.jsonld index 57ba2d0..c213bf3 100644 --- a/context/profile-context.jsonld +++ b/context/profile-context.jsonld @@ -66,7 +66,7 @@ }, "generatedAtTime": { "@id": "prov:generatedAtTime", - "@type": "http://www.w3.org/2001/XMLSchema#dateTime" + "@type": "https://www.w3.org/TR/xmlschema11-2/#dateTimeStamp" }, "name": { "@id": "schemaorg:name" diff --git a/xapi-profiles-about.md b/xapi-profiles-about.md index fbf3bf2..cb7b80f 100644 --- a/xapi-profiles-about.md +++ b/xapi-profiles-about.md @@ -210,6 +210,7 @@ even if there no requirement in a given area. * [Statement Template](#statementtemplate) * [StatementRef](#statementref) * [Subregistration](#subregistration) +* [Timestamp](#timestamp) * [Verb](#verb) * [xAPI Profile Processor Library](#library) @@ -281,6 +282,8 @@ even if there no requirement in a given area. **Subregistration**: When multiple Patterns are being followed within a registration, subregistration is an extension specific to this specification to distinguish between them. +**Timestamp**: An instant of time (date and time) that also includes the time zone. This data type adheres to the [XSD 1.1 dateTimeStamp](https://www.w3.org/TR/xmlschema11-2/#dateTimeStamp) type definition. That is, a timestamp is either represented in Universal Coordinated Time (UTC) and uses the UTC timezone identifier 'Z' or includes a time offset from UTC. + **Verb**: An [Experience API Verb](https://github.com/adlnet/xAPI-Spec/blob/master/xAPI-Data.md#verb). This specification helps Profile Authors provide additional metadata about verbs they control. **xAPI Profile Processor Library**: A programming library implementing the algorithms described in this specification. diff --git a/xapi-profiles-communication.md b/xapi-profiles-communication.md index 9d68a63..1ad0b7b 100644 --- a/xapi-profiles-communication.md +++ b/xapi-profiles-communication.md @@ -405,6 +405,11 @@ order insofar as that can be determined. If Statements are received in the same are being checked upon receipt, within the batch Statements MUST be ordered first by timestamp, and if timestamps are the same, by order within the Statement array, with lower indices earlier. + +**Note:** As stated in section [Part One: About xAPI Profiles, section 3](./xapi-profiles-about.md#timestamp) +timestamps adheres to the `xsd:dateTimeStamp` data type defined in XSD 1.1 which is either represented in +Universal Coordinated Time (UTC) and uses the UTC timezone identifier 'Z' or includes a time offset from UTC. + ## 3.0 Libraries diff --git a/xapi-profiles-structure.md b/xapi-profiles-structure.md index 91275c8..528fdc9 100644 --- a/xapi-profiles-structure.md +++ b/xapi-profiles-structure.md @@ -117,7 +117,7 @@ Property | Type | Description | Required -------- | ---- | ----------- | -------- `id` | IRI | The IRI of the version ID | Required `wasRevisionOf` | Array | An array, usually of length one, of IRIs of all Profile versions this version was written as a revision of | Optional -`generatedAtTime` | Timestamp | The date this version was created on | Required +`generatedAtTime` | [Timestamp](./xapi-profiles-about.md#timestamp) | The date this version was created on | Required `wasRevisionOf` MUST be used with all versions that succeed other Profile versions.