Skip to content

Instantly share code, notes, and snippets.

@carltongibson

carltongibson/draft.md

Last active August 29, 2015 14:10
Show Gist options
  • Save carltongibson/175b257aefc0e56d15c1 to your computer and use it in GitHub Desktop.
Save carltongibson/175b257aefc0e56d15c1 to your computer and use it in GitHub Desktop.
Download ZIP
Thoughts for DRF Third Party Packages Page
Raw
draft.md

General Outline:

  1. About Third Party Packages
  2. How to create a Third Party Package
  3. Existing Third Party Packages
  4. Other Resources

About Third Party Packages

Third Party Packages allow developers to share code that extends the functionality of Django REST framework, in order to support additional use-cases.

We support, encourage and strongly favour the creation of Third Party Packages to encapsulate new behaviour rather than adding additional functionality directly to Django REST Framework.

We aim to make creating Third Party Packages as easy as possible, whilst keeping the simplicity of the core API and ensuring that maintainance of the main project remains under control. If a Third Party Package proves popular it is relatively easy to move it into the main project; removing features is much more problematic.

If you have an idea for a new feature please consider how it may be packaged as a Third Party Package. We're always happy to dicuss ideas on the Mailing List.

How to create a Third Party Package

... and so on...

@tomchristie
Copy link

Yeah, perfect in tone.

Let's have "that extends the functionality of Django REST framework, in order to..." and "rather than adding additional functionality directly to Django REST Framework".

Not super keep on the "Django REST Framework's Core" phrase, think we should avoid the possessive style if possible.

@carltongibson
Copy link
Author

OK — Thanks Tom. Updated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment