summaryrefslogtreecommitdiff
path: root/docs/topics
diff options
context:
space:
mode:
authorNatalia <124304+nessita@users.noreply.github.com>2026-01-07 16:51:33 -0300
committernessita <124304+nessita@users.noreply.github.com>2026-01-08 10:50:56 -0300
commit1717332ca2b39f28cd734e2c91a84bbdc0718b7e (patch)
tree91705e060c39a32346e7c15a51c721a2aa7b09e6 /docs/topics
parentfd5def6367b835784d9d35927433499345b335e7 (diff)
Relocated content from docs/topics/external-packages.txt where appropriate.
Following up a forum post and a conversation with the Steering Council, it was decided to remove the docs/topics/external-packages.txt to avoid confusion with the Ecosystem page. Relevant content was moved to their related sections, except for `django-contrib-comments` which is not actively maintained. Thank you Tim Schilling for the review.
Diffstat (limited to 'docs/topics')
-rw-r--r--docs/topics/external-packages.txt38
-rw-r--r--docs/topics/forms/index.txt4
-rw-r--r--docs/topics/i18n/formatting.txt8
-rw-r--r--docs/topics/index.txt1
4 files changed, 12 insertions, 39 deletions
diff --git a/docs/topics/external-packages.txt b/docs/topics/external-packages.txt
deleted file mode 100644
index 4dc863ba1c..0000000000
--- a/docs/topics/external-packages.txt
+++ /dev/null
@@ -1,38 +0,0 @@
-=================
-External packages
-=================
-
-Django ships with a variety of extra, optional tools that solve common
-problems (``contrib.*``). For easier maintenance and to trim the size of the
-codebase, a few of those applications have been moved out to separate projects.
-
-Localflavor
-===========
-
-``django-localflavor`` is a collection of utilities for particular countries
-and cultures.
-
-* `GitHub <https://github.com/django/django-localflavor>`__
-* `Documentation <https://django-localflavor.readthedocs.io/>`__
-* :pypi:`PyPI <django-localflavor>`
-
-Comments
-========
-
-``django-contrib-comments`` can be used to attach comments to any model, so you
-can use it for comments on blog entries, photos, book chapters, or anything
-else. Most users will be better served with a custom solution, or a hosted
-product like Disqus.
-
-* `GitHub <https://github.com/django/django-contrib-comments>`__
-* `Documentation <https://django-contrib-comments.readthedocs.io/>`__
-* :pypi:`PyPI <django-contrib-comments>`
-
-Formtools
-=========
-
-``django-formtools`` is a collection of assorted utilities to work with forms.
-
-* `GitHub <https://github.com/jazzband/django-formtools/>`__
-* `Documentation <https://django-formtools.readthedocs.io/>`__
-* :pypi:`PyPI <django-formtools>`
diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt
index 04c795352f..ba78b43023 100644
--- a/docs/topics/forms/index.txt
+++ b/docs/topics/forms/index.txt
@@ -856,3 +856,7 @@ This covers the basics, but forms can do a whole lot more:
:doc:`The Forms Reference </ref/forms/index>`
Covers the full API reference, including form fields, form widgets,
and form and field validation.
+
+ :pypi:`django-formtools`
+ Provides additional form utilities, such as form previews and wizards
+ (`documentation <https://django-formtools.readthedocs.io/>`_).
diff --git a/docs/topics/i18n/formatting.txt b/docs/topics/i18n/formatting.txt
index ed941a20e0..62ce308d3c 100644
--- a/docs/topics/i18n/formatting.txt
+++ b/docs/topics/i18n/formatting.txt
@@ -47,6 +47,14 @@ argument::
product = forms.CharField()
revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)
+Locale specific helpers
+-----------------------
+
+For country specific form fields, validation, and data formats that are not
+included in Django itself, consider using the :pypi:`django-localflavor`
+package, which provides localized form fields and utilities for many countries
+and regions (`documentation <https://django-localflavor.readthedocs.io/>`_).
+
.. _topic-l10n-templates:
Controlling localization in templates
diff --git a/docs/topics/index.txt b/docs/topics/index.txt
index 59484d9799..8df59f63f2 100644
--- a/docs/topics/index.txt
+++ b/docs/topics/index.txt
@@ -31,6 +31,5 @@ Introductions to all the key parts of Django you'll need to know:
settings
signals
checks
- external-packages
async
tasks