Skip to content

Commit

Permalink
Update docs on why to use django-nested-admin
Browse files Browse the repository at this point in the history
  • Loading branch information
fdintino committed Mar 18, 2020
1 parent 30af1e3 commit ad1ac93
Showing 1 changed file with 20 additions and 3 deletions.
23 changes: 20 additions & 3 deletions docs/why_use.rst
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,27 @@ Why use django-nested-admin?
| Django Version support | 3.0 | 1.11 | 1.4? | 1.9 | 3.0 |
+-------------------------+------------------------+-------------------------+--------------------------+----------------------+-------------------------+

Above, you will find a feature comparison of all other implementations of nested inlines in the django admin of which I am aware. `django-nested-inline`_, `django-nested-inlines`_, and `dj-nested-inlines`_ are all variations upon `a patch <https://code.djangoproject.com/attachment/ticket/9025/nested_inlines_finished.diff>`_ posted to Django `ticket #9025 <https://code.djangoproject.com/ticket/9025>`_. `django-nested-inlines`_ has had no commits since 2013 and appears to be abandoned, with `dj-nested-inlines`_ being a better maintained fork. It, along with `django-nested-inline`_, are maintained insofar as the maintainers merge in pull requests and update PyPI, but they do not appear to be working on improving these implementations themselves. `django-super-inlines`_ is a fresher take on the problem, and looks to be more promising.
Above, you will find a feature comparison of all other implementations of nested inlines in the
django admin of which I am aware. `django-nested-inline`_, `django-nested-inlines`_, and
`dj-nested-inlines`_ are all variations upon
`a patch <https://code.djangoproject.com/attachment/ticket/9025/nested_inlines_finished.diff>`_
posted to Django `ticket #9025 <https://code.djangoproject.com/ticket/9025>`_.
`django-nested-inlines`_ has had no commits since 2013 and appears to be abandoned.
`dj-nested-inlines`_ picked up the baton, and made numerous bug fixes, but then stopped receiving
updates in 2016. `django-nested-inline`_ is the best variation upon the original patch; it has
recently gained a new maintainer, and now even supports the latest version of Django.
`django-super-inlines`_ is a
fresh take on the problem, and had initially appeared promising, but it has since lapsed into an
unmaintained state.

The largest functional difference between `django-nested-admin`_ and these other projects is its support for drag-and-drop sorting functionality within and between inlines, similar to Grappelli’s sortable inline feature (though it does not require Grappelli). It also has fairly extensive test coverage. And lastly `django-nested-admin`_ is and will remain an integral part of the CMS that powers `TheAtlantic.com`_ (and `CityLab.com`_) where it is used by editors to curate the homepages, email newsletters, and landing pages for special projects and site sections (the way we used `django-nested-admin`_ to power the curation of `TheAtlantic.com`_’s homepage was the subject of `a talk we gave at the 2015 Djangocon <https://www.youtube.com/watch?v=RWLQTCUpyWw>`_).
The largest functional difference between `django-nested-admin`_ and these other projects is its
support for drag-and-drop sorting functionality within and between inlines, similar to
Grappelli’s sortable inline feature (though it does not require Grappelli). It also has fairly
extensive test coverage. And lastly `django-nested-admin`_ is and will remain an integral part
of the CMS that powers `TheAtlantic.com`_ where it is used by editors to curate the homepages,
email newsletters, and landing pages for special projects and site sections (the way we used
`django-nested-admin`_ to power the curation of `TheAtlantic.com`_’s homepage was the subject of
`a talk we gave at the 2015 Djangocon <https://www.youtube.com/watch?v=RWLQTCUpyWw>`_).


.. _django-nested-admin: https://github.com/theatlantic/django-nested-admin
Expand All @@ -33,4 +51,3 @@ The largest functional difference between `django-nested-admin`_ and these other
.. _dj-nested-inlines: https://github.com/silverfix/dj-nested-inlines
.. _django-super-inlines: https://github.com/BertrandBordage/django-super-inlines
.. _TheAtlantic.com: http://www.theatlantic.com/
.. _CityLab.com: http://www.citylab.com/

0 comments on commit ad1ac93

Please sign in to comment.