diff --git a/docs/howto/config.rst b/docs/howto/config.rst index b3e3cb5e1..a68d6d496 100644 --- a/docs/howto/config.rst +++ b/docs/howto/config.rst @@ -221,26 +221,30 @@ contact_person ^^^^^^^^^^^^^^ This is only used by *make_metadata.py* when it constructs the metadata for -the service described by the configuration file. -This is where you describe who can be contacted if questions arise -about the service or if support is needed. The possible types are according to -the standard **technical**, **support**, **administrative**, **billing** -and **other**.:: +the service described by the configuration file. This is where you describe +who can be contacted if questions arise about the service or if support is +needed. + +Note that `contact_type` is required for a valid schema. The possible types +are according to the standard **technical**, **support**, **administrative**, +**billing** and **other**:: contact_person: [ { - "givenname": "Derek", - "surname": "Jeter", + "given_name": "Derek", + "sur_name": "Jeter", "company": "Example Co.", - "mail": ["jeter@example.com"], - "type": "technical", + "email_address": ["jeter@example.com"], + "telephone_number": ["123-456-789", "+1 234 567 89"] + "contact_type": "technical", }, { - "givenname": "Joe", - "surname": "Girardi", + "given_name": "Joe", + "sur_name": "Girardi", "company": "Example Co.", - "mail": "girardi@example.com", - "type": "administrative", + "email_address": ["girardi@example.com", "admin@example.com"] + "telephone_number": ["987-654-321"] + "contact_type": "administrative", }, ] @@ -1481,11 +1485,11 @@ We start with a simple but fairly complete Service provider configuration:: } "contact_person": [ { - "givenname": "Roland", - "surname": "Hedberg", - "phone": "+46 90510", - "mail": "roland@example.com", - "type": "technical", + "given_name": "Roland", + "sur_name": "Hedberg", + "telephone_number": ["+46 90510"], + "email_address": ["roland@example.com"], + "contact_type": "technical", }, ] } @@ -1539,11 +1543,11 @@ A slightly more complex configuration:: } "contact_person": [ { - "givenname": "Roland", - "surname": "Hedberg", - "phone": "+46 90510", - "mail": "roland@example.com", - "type": "technical", + "given_name": "Roland", + "sur_name": "Hedberg", + "telephone_number": ["+46 90510"], + "email_address": ["roland@example.com"], + "contact_type": "technical", }, ] }