aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source
diff options
context:
space:
mode:
authorAnthony Crumley <anthony.crumley@gmail.com>2018-06-28 07:36:11 -0500
committerAnthony Crumley <anthony.crumley@gmail.com>2018-06-28 07:58:30 -0500
commitd90b7726e110c23e76163d0f2e413432bbd4c695 (patch)
treede821b566ae59b52d7eec43fc2c3ca12875a21b4 /guides/source
parent08dde0f355e0450bc2cb7e0b4b95a0ec18d1a870 (diff)
downloadrails-d90b7726e110c23e76163d0f2e413432bbd4c695.tar.gz
rails-d90b7726e110c23e76163d0f2e413432bbd4c695.tar.bz2
rails-d90b7726e110c23e76163d0f2e413432bbd4c695.zip
Improve wording for form_with in Getting Started Guide
[ci skip] Improved wording by making it clear the form_with helper method was being referenced in the first paragraph and that the second paragraph is a continuation of the form_with train of thought. Additionally, a connection was made to examples of the form_with usage being described.
Diffstat (limited to 'guides/source')
-rw-r--r--guides/source/getting_started.md9
1 files changed, 5 insertions, 4 deletions
diff --git a/guides/source/getting_started.md b/guides/source/getting_started.md
index de2c459cff..61658cdfc9 100644
--- a/guides/source/getting_started.md
+++ b/guides/source/getting_started.md
@@ -1203,14 +1203,15 @@ it look as follows:
This time we point the form to the `update` action, which is not defined yet
but will be very soon.
-Passing the article object to the method will automatically set the URL for
+Passing the article object to the `form_with` method will automatically set the URL for
submitting the edited article form. This option tells Rails that we want this
form to be submitted via the `PATCH` HTTP method, which is the HTTP method you're
expected to use to **update** resources according to the REST protocol.
-The arguments to `form_with` could be model objects, say, `model: @article` which would
-cause the helper to fill in the form with the fields of the object. Passing in a
-symbol scope (`scope: :article`) just creates the fields but without anything filled into them.
+Also, passing a model object to `form_with`, like `model: @article` in the edit
+view above, will cause form helpers to fill in form fields with the corresponding
+values of the object. Passing in a symbol scope such as `scope: :article`, as
+was done in the new view, only creates empty form fields.
More details can be found in [form_with documentation]
(http://api.rubyonrails.org/classes/ActionView/Helpers/FormHelper.html#method-i-form_with).