Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

prerequisites property #210

Open
thill-odi opened this issue Jun 19, 2019 · 3 comments
Open

prerequisites property #210

thill-odi opened this issue Jun 19, 2019 · 3 comments
Labels
proposal Proposed changes to the specification

Comments

@thill-odi
Copy link
Contributor

thill-odi commented Jun 19, 2019

Proposer

ODI

Use Case

As a participant in a sporting activity, I want to know what formal qualifications (e.g., swimming certificate, archery training, health commitment statement) I need to fulfil to participate in an activity.

As an activity provider, I want to feel assured that all participants in my activity have the necessary formal qualifications to participate in it.

As an activity provider, I need to provide guarantees to my insurers that all participants in my activities are fit and able to do so.

Why is this not covered by existing properties?

This is simply not modelled anywhere in the Opportunity specification. termsOfService in the Booking spec is the closest thing we've got to this - but the domain is quite different.

Please provide a link to example data

Health Commitment Statements:

Background: http://test.ukactive.com/wp-content/uploads/2016/06/ukactive_HCS-1.pdf
Example: https://www.lifestyle-intervention.uk/health-commitment-statement

Similarly, snorkelling/SCUBA: https://www.bsac.com/training/learn-to-snorkel/fit-to-snorkel/

Mandatory certification prior to booking opportunities:

(nb: it's not clear whether the comparative difficulty of getting this information is an argument for or against including it in the spec)

Archery: http://www.archeryuk.uk/prices.html.

Snorkelling/Scuba: https://www.bsac.com/already-a-diver/

Wall-climbing: https://www.mileendwall.org.uk/courses/detail/roped-climbing-for-beginners

Qualifications and Gradations

Swimming grades: https://www.better.org.uk/facilities-and-activities/lessons-and-courses/swimschool

Iyengar yoga, graded in terms of length of practice: https://iymv.org/iyengar-yoga-london-class-levels/

Proposal

Addition of a prerequisites array property, with a REQUIRED "name" property, a RECOMMENDED "url" attribute, and an OPTIONAL "description" field.

Example

"prerequisites":[
   {
      "name":"Snorkel self-declaration medical fitness form",
      "url":"https://www.bsac.com/training/learn-to-snorkel/fit-to-snorkel/",
      "description":"Snorkelling requires a reasonable level of fitness and there are some medical conditions that may prevent someone taking up the sport."
   },
   {
      "name":"British Sub Aqua Club Ocean Diver Certification",
      "url":"https://www.bsac.com/training/learn-to-scuba-dive/ocean-diver-course/#tab-1",
      "description":"If you’re keen to learn to dive, the BSAC’s Ocean Diver course is the place to start."
   }
]
@thill-odi thill-odi changed the title prerequisite property prerequisites property Jun 19, 2019
@thill-odi thill-odi added the proposal Proposed changes to the specification label Jun 20, 2019
@thill-odi
Copy link
Contributor Author

Though we've more-or-less agreed to park this one until we've got more providers with this kind of data, I thought I'd throw down a couple of notes here from the 19 June call.

  1. It was suggested that we include some kind of ability to link to opportunities to gain the prerequisites - though what exact form this linkage would take, and how formalised it needed to be (simply a URL? A range of schema.org or OpenActive types?) remained open questions.
    1a. Part of this question seemed to revolve around exactly what we're modelling: there's a (meaningful?) difference between a full-on 11-week SCUBA training course and a 30-minute intro to wall-climbing before you can use the facilities.
  2. Possibly the idea of a separate attribute here is simply overkill, and this information is better communicated in a freetext general description field.
  3. What this is largely capturing is the distinction between 'novice' and 'beginner', discussed at Proposal: Consistent levels #82.

@thill-odi
Copy link
Contributor Author

Reviewing some of the questionnaire feedback, it seems clear that a number of sports and activities have prerequisites based on some kind of minimal safety training or experience - and that these prerequisites at times have legal or insurance implications (see e.g. Archery, Snorkelling, and Swimming)

The proposal, then, is to create another subclass of oa:Terms, along the lines of oa:PrivacyPolicy or oa:TermsOfUse, the purpose of which is two-fold:

  • to prompt the user to check that they are appropriately credentialled and prepared for the Opportunity they are attempting to enrol in
  • to provide them with a link to an Opportunity whereby they can acquire the appropriate training, if they do not have it already.

So:

{
"type": "Prerequisites",
"name": "Duckling 4",
"url":" https://www.swimming.org/learntoswim/asa-duckling-awards/",
"requiresExplicitConsent":"true",
"relatedLink":"https://ducklingsanddolphins.co.uk/project/duckling-awards-1-4/"
}

@thill-odi
Copy link
Contributor Author

Suggestions from @nickevansuk via the W3C call:

  1. In order to deal with situations were a number of different qualifications might exist (as in e.g. harmonised Welsh and English diving qualifications), this should be modelled as an array, with requiresExplicitConsent or similar in the parent.
  2. More research is needed to make sure we're covering all cases here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
proposal Proposed changes to the specification
Projects
None yet
Development

No branches or pull requests

1 participant