openreferral / specification

The Human Services Data Specification - a data exchange format developed by the Open Referral Initiative
https://openreferral.org
Other
117 stars 49 forks source link

Documentation Does Not List Acceptable Values For Enum Fields #212

Closed AtticusRains closed 10 months ago

AtticusRains commented 4 years ago

The HSDS objects and fields reference documentation currently does not list acceptable values for enum fields (or denote that these fields are enums at all) as described in the datapackage.json

For example, the eligibility.eligibility field is described in the datapackage.json as follows:

{
    "name": "eligibility",
    "description": "The rules or guidelines that determine who can receive the service.",
    "type": "string",
    "constraints": {
        "enum": ["adult","child","teen","family","female","male",
            "Transgender", "Transgender - M to F", "Transgender - F to M" ]
    }
}

The documentation makes this field seem more like an open text field and does not list the acceptable values.

Field Name Type (Format) Description Required? Unique?
eligibility string The rules or guidelines that determine who can receive the service. False False
MikeThacker1 commented 4 years ago

Yes it is currently defined just as a text field. In the UK we're proposing an extension so that eligibility can come from a taxonomy/vocabulary. See issue 208.

mrshll1001 commented 10 months ago

Closing this as we no longer have eligibility modelled in this way. However I'm noting that there's been several other issues discussing how enums in the standard are not rendered properly.

Usually this is handled separately, via a codelists page. I am noting this down in our project docs as being related to this.