adlnet / xapi-profiles

A set of documents addressing the structure of and supporting services for xAPI Profiles.
https://adlnet.gov/projects/xapi/
Apache License 2.0
54 stars 27 forks source link

add extensive clarification on who is required to follow what #187

Closed fugu13 closed 7 years ago

fugu13 commented 7 years ago

Basically, some requirements are more easily stated as requirements of form, and others are more easily stated as requirements of somebody doing something. Instead of transforming every requirement of form into a sometimes awkward requirement of someone doing something, I've extended the document interpretation section a little:

  • All requirements on the structure of Profiles MUST be followed by Profile Authors.
  • All requirements on Statements following Profiles MUST be followed by Learning Record Providers when authoring Statements and by Profile Validators when validating Statements.

Additionally, in a number of places I've phrased things as requirements for Learning Record Providers, and added an additional requirement after for Profile Validators (we'll add a clarifying definition) to validate that the requirements for Learning Record Providers were followed.