Skip to content

Proposal: genderRestriction changes #69

Open
@ldodds

Description

@ldodds

Proposer

This has been proposed based on reviewing currently published data

Use Case

  • as a participant I want to know whether an event is suitable for me
  • as a data user I want to be able to reliably filter events, e.g. to help women find women only events

Why is this not covered by existing properties?

This is a proposed change to the existing genderRestriction property

The change will effect the following publishers:

  • activeNewham
  • fusion
  • GLL
  • Good Gym
  • Lawn Tennis Association
  • Leisure World Colchester
  • Salford Community Leisure
  • Sport Starta
  • Vision Redbridge Culture & Leisure

Proposal

genderRestriction is currently a literal value. It's defined as having values of "male", "female" or "mixed". However people are using inconsistent values ("Male"), or incorrect values ("men"/"women")

A small non-breaking change (which would only impact Lawn Tennis Association and Sport Starta) would be to more clearly specify the expected values. E.g. require them to be "male", "female", "mixed" to be valid.

The alternative proposal is to use URIs for values rather than string literals. For example Schema.org defines http://schema.org/Male and http://schema.org/Female.

We could define three URIs for gender restrictions:

  • http://openactive.io/ns#Male
  • http://openactive.io/ns#Female
  • http://openactive.io/ns#None

Other than this the property stays the same:

  • if genderRestriction is not supplied then consumers SHOULD assume the value is http://openactive.io/ns#None
  • if supplied it can only have a single string value, which must be one of the URIs
  • a value of http://openactive.io/ns#None indicates that the event has no restrictions
  • a value of http://openactive.io/ns#Male indicates that the event is restricted to the male gender
  • a value of http://openactive.io/ns#Female indicates that the event is restricted to the female gender

This usage and naming aligns with GDS recommendations

Example

{
"@context": "https://www.openactive.io/ns/oa.jsonld",
"type": "Event",
"genderRestriction": "http://openactive.io/ns#Female"
}

Metadata

Metadata

Assignees

Labels

discussionGeneral discussion question, not yet a formal proposal

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions