Just a heads’up this is a topic that has been in active discussions in public and private for the last 5 (10?) years, so a lot of this will have been proposed and discussed, many times. More recently, in the new features repository, search for “REST” or “API”. This is probably the best place to make actual proposals. As noted there’s been movement with the docs, this is pretty intentional, incremental work on a “REST story”.
Also worth a mention – this kind of work doesn’t come for free? The opportunity cost is tremendous. If we choose to do “nothing” or only small steps with regards to REST APIs, it also means our contributors get to coordinate on other topics that are a better fit / more achievable. When we did an (informal) roadmap session with contributors in January 2024, “built-in API framework” was the top #6 item. So there were 5 things that were more appealing to people in that room. And of all the items in that list, REST improvements scored highest on “effort needed”, and didn’t score highest on “perceived impact”. So worth thinking about that too.
Oh last thing re marketing – I’m looking for someone to contribute a “Django ninja intro / how-to” post for the Django blog. If you’re interested please DM me. See Building better APIs: from Django to client libraries with OpenAPI as an example (with REST Framework).