Hi everyone, One of the results of discussions at Django Under The Hood was support for the idea of marking APIs "experimental" - that is, document them and include them in mainline Django releases, but away from the standard Django deprecation cycle while still not hiding them under the "Internal" moniker (these would be APIs for public consumption).
Of particular interest here is the issues we faced with some of the migration APIs during the 1.7 release; 1.7 might have been able to release faster if we could have released early with some parts of migrations and the schema editor marked as "experimental" and iterated on it during the main release cycle, and communicated with third-party database backends more effectively and given them documentation and release notes. There's an extra consideration here if we should extend the proposed part of the release notes listing experimental changes to also include internal changes, and possibly a separate discussion to be had about marking some of the Django database API as stable (or experimental for a release or two, then upgrade them). The pull request for the DEP is here: https://github.com/django/deps/pull/10 (If you're not familiar with the updated DEP process, you should read the new DEP 1 at https://github.com/django/deps/blob/master/final/0001-dep-process.rst - but, quickly, the pull request is for both corrections to the layout and spelling and content suggestions, though this thread is the best place for long-form discussion). Discussion welcome! This is by no means a final proposal, just a first draft. Andrew -- You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/django-developers. To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/CAFwN1uqkeuZ1GMWdYhN_X9nvmKLXz61CTdqWzdef8OK6%2BRha3Q%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
