Skip to content

2.5 Validation API changes#4233

Merged
weaverryan merged 10 commits into2.5from
validation-api-changes
Oct 18, 2014
Merged

2.5 Validation API changes#4233
weaverryan merged 10 commits into2.5from
validation-api-changes

Conversation

@weaverryan
Copy link
Copy Markdown
Contributor

Q A
Doc fix? no
New docs? yes
Applies to 2.5
Fixed tickets #4094

Hi guys!

This takes the work in #4056, #4105 and #4161 and extends it based on some feedback. Basically, the whole validation stuff is quite difficult, because:

A) We want to show the non-deprecated methods so people use the new stuff
B) We don't want to confuse users on the 2.4 API (even though this number of users should be very small, as it would require you to have started a project in the past and be using 5.3.9 and lower #4105 (comment))

This solution is to show the new way, but always show the old way in comments. This would check of A and B in #4094.

Thanks!

@stof
Copy link
Copy Markdown
Member

stof commented Sep 16, 2014

Please add a note in the bundle best practices sayignt hat shared bundles MUST support both the 2.4 and the 2.5 validation API, given they don't know which one is used in a project. An example should be provided showing how to do it

@fabpot
Copy link
Copy Markdown
Member

fabpot commented Sep 16, 2014

bundle best practices": public bundle (vs project bundle.)

@xabbuh
Copy link
Copy Markdown
Member

xabbuh commented Sep 16, 2014

The cookbook chapter about form testing should probably also be updated (see for example the changes in #4213). What do you think?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The buildViolation method [...]

@weaverryan
Copy link
Copy Markdown
Contributor Author

Thanks for the feedback! I've just added a section to the bundle best-practices doc, which could use a quick review.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would add a use statement for this class. (and for all 3 classes used in this example actually)

nicolassing and others added 9 commits October 2, 2014 08:43
@weaverryan weaverryan force-pushed the validation-api-changes branch from baeae98 to 94fc520 Compare October 2, 2014 12:49
@weaverryan
Copy link
Copy Markdown
Contributor Author

Hi guys!

I made a few tweaks (including updating the form testing chapter) at sha: 94fc520 and then also tackled the changes to validateValue() and validate() (see items E and F in #4094, which came from #4242) - see sha: 9874d8e.

One last review would be awesome because these changes are confusing, so I want them to be perfect in the docs.

Thanks!

@weaverryan weaverryan merged commit 9874d8e into 2.5 Oct 18, 2014
weaverryan added a commit that referenced this pull request Oct 18, 2014
…, weaverryan)

This PR was merged into the 2.5 branch.

Discussion
----------

2.5 Validation API changes

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.5
| Fixed tickets | #4094

Hi guys!

This takes the work in #4056, #4105 and #4161 and extends it based on some feedback. Basically, the whole validation stuff is quite difficult, because:

A) We want to show the non-deprecated methods so people use the new stuff
B) We don't want to confuse users on the 2.4 API (even though this number of users should be very small, as it would require you to have started a project in the past and be using 5.3.9 and lower #4105 (comment))

This solution is to show the new way, but always show the old way in comments. This would check of A and B in #4094.

Thanks!

Commits
-------

9874d8e [#4233][#4094] Making validateValue and validate changes
94fc520 Minor tweaks and a missing location thanks to xabbuh and WouterJ
f97ba7a Fixes thanks to @xabbuh
279d8d6 Adding a section about keeping BC in a re-usable bundle
280440e Adding details about the 2.4 API as comments
e658b56 added a versionadded comment to Callback.rst
70c5ca1 Update custom_contraint.rst to meet the new 2.5 api
5dfe499 Don't use deprecated functions in Callback.rst
f4380ed Update Callback.rst
042dcf9 Replace addViolationAt (deprecated) by buildViolation
@weaverryan weaverryan deleted the validation-api-changes branch October 18, 2014 19:36
weaverryan added a commit that referenced this pull request Oct 18, 2014
* 2.5:
  Putting #pull-request-format anchor link back, which we link to in our contrib notes
  Re-adding one more version
  [#4290] Re-adding version back
  Fixing bad link
  Updating library/bundle installation docs to use the new composer require (no version) functionality
  [#4233][#4094] Making validateValue and validate changes
  Minor tweaks and a missing location thanks to xabbuh and WouterJ
  Fixes thanks to @xabbuh
  Adding a section about keeping BC in a re-usable bundle
  Adding details about the 2.4 API as comments
  added a versionadded comment to Callback.rst
  Update custom_contraint.rst to meet the new 2.5 api
  Don't use deprecated functions in Callback.rst
  Update Callback.rst
  Replace addViolationAt (deprecated) by buildViolation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants