diff options
author | Anthony Crumley <anthony.crumley@gmail.com> | 2018-06-28 07:36:11 -0500 |
---|---|---|
committer | Anthony Crumley <anthony.crumley@gmail.com> | 2018-06-28 07:58:30 -0500 |
commit | d90b7726e110c23e76163d0f2e413432bbd4c695 (patch) | |
tree | de821b566ae59b52d7eec43fc2c3ca12875a21b4 /guides/source | |
parent | 08dde0f355e0450bc2cb7e0b4b95a0ec18d1a870 (diff) | |
download | rails-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.md | 9 |
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). |