Skip to content

[Reference][Form Types] Add missing docs for "action" and "method" option #3436

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

Merged
merged 7 commits into from
Mar 4, 2014
Merged

[Reference][Form Types] Add missing docs for "action" and "method" option #3436

merged 7 commits into from
Mar 4, 2014

Conversation

bicpi
Copy link
Contributor

@bicpi bicpi commented Jan 6, 2014

Q A
Doc fix? no
New docs? yes
Applies to 2.3+
Fixed tickets #3410

I'm not sure of adding these two options as separate rst-files because I don't think they will get listed as inherited options. But no other options are embedded directly. Please let me know if I can improve that.

* PATCH

As PUT, DELETE and PATCH are not nativly supported by most clients, Symfony
simulates them, see :doc:`/cookbook/routing/method_parameters`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for more information see ... || to read more see ...

@weaverryan
Copy link
Member

PATCH also has a special property in that if any fields are missing from the submit, those won't be removed: https://github.com/symfony/symfony/blob/master/src/Symfony/Component/Form/Extension/HttpFoundation/HttpFoundationRequestHandler.php#L80

That uses the 2nd argument of the submit method, which is also not something we mention in the docs, but which is probably out of the scope here.

@bicpi Can you add a quick note about the PATCH behavior? Then, if you're ready, I'd like to merge this!

Cheers!

@wouterj
Copy link
Member

wouterj commented Jan 21, 2014

And this needs a rebase btw

@bicpi
Copy link
Contributor Author

bicpi commented Jan 23, 2014

Rebase done, will work on the missing update soon.

@bicpi
Copy link
Contributor Author

bicpi commented Jan 24, 2014

@weaverryan Added a note about the PATCH method, hope that it's well drafted.

@weaverryan
Copy link
Member

Thanks Philipp - very well done indeed - the slow merge was because of me :). Cheers!

weaverryan added a commit that referenced this pull request Mar 4, 2014
…nd "method" option (bicpi)

This PR was merged into the 2.3 branch.

Discussion
----------

[Reference][Form Types] Add missing docs for "action" and "method" option

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.3+
| Fixed tickets | #3410

I'm not sure of adding these two options as separate rst-files because I don't think they will get listed as `inherited` options. But no other options are embedded directly. Please let me know if I can improve that.

Commits
-------

793c8a0 Add note about the PATCH method
4555495 Update note wording for "method" option
70ca6da Improvements after review
cecc762 Update "method" description
a636945 Fixes after review
83ff4b1 Improve descriptions
1bf3ce0 [Reference][Form Types] Add missing docs for "action" and "method" option
@weaverryan weaverryan merged commit 793c8a0 into symfony:2.3 Mar 4, 2014
weaverryan added a commit that referenced this pull request Mar 12, 2014
This PR was merged into the 2.3 branch.

Discussion
----------

Minor tweaks to form action/method

This adds a little bit more to #3436.

The toughest part is the wording around explaining the PATCH behavior - suggestions warmly welcomed :).

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | no
| Applies to    | 2.3+
| Fixed tickets | none

Thanks!

Commits
-------

34f5b0c Some slight reordering of the form options - and also tweaking language around PATCH behavior
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants