[Specifications] Clarify how to describe HTTP status (#191)

• From: Angelo Veltens via GitHub <sysbot+gh@w3.org>
• Date: Mon, 06 May 2019 12:58:41 +0000
• To: public-hydra-logs@w3.org
• Message-ID: <issues.opened-440687519-1557147520-sysbot+gh@w3.org>

angelo-v has just created a new issue for https://github.com/HydraCG/Specifications:

== Clarify how to describe HTTP status ==
## Description

Hydra Core Vocabulary has serveral terms / types to express status:

`hydra:statusCode`
`hydra:possibleStatus`
`hydra:Status`

Unfortunately the spec does not provide usage examples or prose explanation of how to use it and there are serveral (conflicting or obsolete) examples in the wild.

The spec should explain how to use those.

## 

My usage understanding from the vocabulary is:
```json
"possibleStatus": [
  {
    "@type": "Status",
    "statusCode": 201,
    "description": "If the resource was created successfully."
  }
]
```

Please view or discuss this issue at https://github.com/HydraCG/Specifications/issues/191 using your GitHub account

Received on Monday, 6 May 2019 12:58:42 UTC