required to support old flash/flex clients that need to do everything as
GET requests (apparently to allow for any error handlings)

Filter documentation explanation

Well, I spent some time trying to gues how djang-filter works, and
if this changes would be introduced, I would have saved this time.

paginator should validate page and provide default

better way comming in a seperate pr

Remove the detail=None from APIException signature

The documentation not match with the implementation. The APIException doesn't have detail parameter in the constructor class, actually doesn't have constructor method at all.

- use the standard paginator.validate_number method rather
  strict_postive_int.
- support optional paginator method, default_page_number, to get the default
  page number rather than hard-coding it to 1
- this allows supporting non-integer based pagination which can be an
  important performance tweak on extermely large datasets or high request
  loads
- relatively thorough unit tests of the changes

Mention name of file to edit

Using the filenames where relevant

Added name of file to edit

add @tamakisquare for work on #1111

fix writing into foreign key with non-null source

Test case and fix for issue 1111

Return object in save_object

Fixed #1179: RepresenterError with DecimalField and YAMLRenderer

Put template block around the description

Sometimes it's hard to tell which file the code is intended to go in. Now it spells it out.

To reduce unnecessary cognitive load of the learner, name the file they are putting this code in.

So reader doesn't have to remember, or check through all the files to find where this code fragment was, mention the file name when it is relevant.

The error occurs when serializer is set with partial=True and a
field-level validation is defined on a field, for which there's no
corresponding update value in .data

Add missing commas in relations.md