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

Add more "Web surface" concepts #13

Closed
dret opened this issue Jun 7, 2016 · 8 comments
Closed

Add more "Web surface" concepts #13

dret opened this issue Jun 7, 2016 · 8 comments
Assignees

Comments

@dret
Copy link
Owner

dret commented Jun 7, 2016

right now the only concepts supported are media types, HTTP header field types, and link relation types. There definitely should be HTTP status codes as well. This issue serves to capture ideas about additional concepts that "belong into the web surface" and should be documented in a similar way as media types, HTTP header field types, and link relation types are documented right now.

@dret dret changed the title Add more concepts Add more "Web surface" concepts Jun 7, 2016
@dret
Copy link
Owner Author

dret commented Jun 9, 2016

this is presented as a 5in5 talk at the WS-REST workshop: https://github.com/apiacademy/WSREST2016/wiki/Web-Surface; the WS-REST 2016 discussion identified the following concepts that could be added to the list above:

  • HTTP Status Codes
  • HTTP Request Methods
  • Content Encodings

@dret
Copy link
Owner Author

dret commented Jun 17, 2016

another inspiration for additional web surface coverage are HTTP cache control extensions from @comcast-jonm's API360 talk. one example is this RFC: https://tools.ietf.org/html/rfc5861

@dret
Copy link
Owner Author

dret commented Jun 22, 2016

for the cache control extensions, the relevant IANA registry of "HTTP Cache Directives" is here: http://www.iana.org/assignments/http-cache-directives/http-cache-directives.xhtml

@dret
Copy link
Owner Author

dret commented Jun 22, 2016

the proposals made so far have their own issues now (#14 #15 #16 #17). this issue will remain open as a general discussion topic for adding even more concepts beyond those identified so far.

@dret
Copy link
Owner Author

dret commented Jul 7, 2016

not mentioned here originally, but the (old) issue #4 falls into this generic one as well.

@dret
Copy link
Owner Author

dret commented Jul 7, 2016

#5 qualifies as well, but is based on a long-expired draft, so probably not (yet) ready for prime time.

@dret
Copy link
Owner Author

dret commented Aug 5, 2016

almost done with this one, just a few more #22 values to add.

@dret dret mentioned this issue Aug 7, 2016
@dret dret self-assigned this Dec 8, 2016
@dret
Copy link
Owner Author

dret commented Dec 8, 2016

this issue was resolved a while ago. new concepts should be requested as individual issues.

@dret dret closed this as completed Dec 8, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant