Skip to content

Commit cfa942f

Browse files
committed
Edits to announcement
1 parent 761a034 commit cfa942f

File tree

1 file changed

+10
-33
lines changed

1 file changed

+10
-33
lines changed

docs/topics/3.8-announcement.md

Lines changed: 10 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,8 @@
1919

2020
# Django REST framework 3.8
2121

22-
TODO
23-
24-
The 3.8 release ...
22+
The 3.8 release is a maintenance focused release resolving a large number of previously outstanding issues and laying
23+
the foundations for future changes.
2524

2625
---
2726

@@ -33,18 +32,17 @@ If you use REST framework commercially and would like to see this work continue,
3332

3433
*We'd like to say thanks in particular our premium backers, [Rover](http://jobs.rover.com/), [Sentry](https://getsentry.com/welcome/), [Stream](https://getstream.io/?utm_source=drf&utm_medium=banner&utm_campaign=drf), [Machinalis](https://hello.machinalis.co.uk/), and [Rollbar](https://rollbar.com).*
3534

36-
3735
---
3836

3937
## Breaking Changes
4038

41-
### Altered behaviour of `read_only` plus `default` on Field.
39+
### Altered the behaviour of `read_only` plus `default` on Field.
4240

43-
[#5886][gh5886]
41+
[#5886][gh5886] `read_only` fields will now **always** be excluded from writable fields.
4442

45-
`read_only` fields will now **always** be excluded from writable fields.
46-
47-
Previously `read_only` fields with a `default` value would use the `default` for create and update operations.
43+
Previously `read_only` fields when combined with a `default` value would use the `default` for create and update
44+
operations. This was counter-intuitive in some circumstances and led to difficulties supporting dotted `source`
45+
attributes on nullable relations.
4846

4947
In order to maintain the old behaviour you may need to pass the value of `read_only` fields when calling `save()` in
5048
the view:
@@ -54,40 +52,19 @@ the view:
5452

5553
Alternatively you may override `save()` or `create()` or `update()` on the serialiser as appropriate.
5654

57-
58-
---
59-
60-
## Boolean Composable Permissions
61-
62-
TODO
63-
6455
---
6556

66-
67-
## Namespace Support
57+
## Deprecations
6858

6959
TODO
7060

71-
72-
---
73-
74-
## Viewset actions
75-
76-
TODO:
77-
7861
---
7962

8063
## Minor fixes and improvements
8164

82-
There are a large number of minor fixes and improvements in this release. See the [release notes](release-notes.md) page for a complete listing.
83-
84-
---
85-
86-
## Deprecations
65+
There are a large number of minor fixes and improvements in this release. See the [release notes](release-notes.md) page
66+
for a complete listing.
8767

88-
TODO
89-
90-
---
9168

9269
## What's next
9370

0 commit comments

Comments
 (0)