From dbb636034f20736e16eb9d6c809217c9525b6cbd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= <essen@ninenines.eu>
Date: Fri, 15 Jan 2016 16:14:46 +0100
Subject: Minor grammar improvements from Derek Brown

[ci-skip]
---
 doc/src/guide/resource_design.asciidoc | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

(limited to 'doc/src/guide/resource_design.asciidoc')

diff --git a/doc/src/guide/resource_design.asciidoc b/doc/src/guide/resource_design.asciidoc
index a8a6648..691953f 100644
--- a/doc/src/guide/resource_design.asciidoc
+++ b/doc/src/guide/resource_design.asciidoc
@@ -8,7 +8,7 @@ It is meant to be usable as a step by step guide.
 === The service
 
 Can the service become unavailable, and when it does, can
-we detect it? For example database connectivity problems
+we detect it? For example, database connectivity problems
 may be detected early. We may also have planned outages
 of all or parts of the system. Implement the
 `service_available` callback.
@@ -31,7 +31,7 @@ the same handler.
 
 Skip this section if you are not doing a collection.
 
-Is the collection hardcoded or dynamic? For example
+Is the collection hardcoded or dynamic? For example,
 if you use the route `/users` for the collection of
 users then the collection is hardcoded; if you use
 `/forums/:category` for the collection of threads
@@ -122,8 +122,8 @@ Can access to a resource be forbidden regardless of access
 being authorized? A simple example of that is censorship
 of a resource. Implement the `forbidden` callback.
 
-Is there any constraints on the length of the resource URI?
-For example the URI may be used as a key in storage and may
+Are there any constraints on the length of the resource URI?
+For example, the URI may be used as a key in storage and may
 have a limit in length. Implement `uri_too_long`.
 
 === Representations
@@ -132,7 +132,7 @@ What media types do I provide? If text based, what charsets
 are provided? What languages do I provide?
 
 Implement the mandatory `content_types_provided`. Prefix
-the callbacks with `to_` for clarity. For example `to_html`
+the callbacks with `to_` for clarity. For example, `to_html`
 or `to_text`.
 
 Implement the `languages_provided` or `charsets_provided`
@@ -153,7 +153,7 @@ the `multiple_choices` callback.
 === Redirections
 
 Do I need to keep track of what resources were deleted?
-For example you may have a mechanism where moving a
+For example, you may have a mechanism where moving a
 resource leaves a redirect link to its new location.
 Implement the `previously_existed` callback.
 
@@ -196,7 +196,7 @@ If you implement the methods PUT, POST and/or PATCH,
 you must implement the `content_types_accepted` callback,
 and one `AcceptResource` callback for each content-type
 it returns. Prefix the `AcceptResource` callback names
-with `from_` for clarity. For example `from_html` or
+with `from_` for clarity. For example, `from_html` or
 `from_json`.
 
 Do we want to allow the POST method to create individual
-- 
cgit v1.2.3

