From 1717332ca2b39f28cd734e2c91a84bbdc0718b7e Mon Sep 17 00:00:00 2001 From: Natalia <124304+nessita@users.noreply.github.com> Date: Wed, 7 Jan 2026 16:51:33 -0300 Subject: 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. --- docs/ref/models/fields.txt | 10 ---------- docs/topics/external-packages.txt | 38 -------------------------------------- docs/topics/forms/index.txt | 4 ++++ docs/topics/i18n/formatting.txt | 8 ++++++++ docs/topics/index.txt | 1 - 5 files changed, 12 insertions(+), 49 deletions(-) delete mode 100644 docs/topics/external-packages.txt (limited to 'docs') diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index fe4d764ab3..308c93d868 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -10,16 +10,6 @@ Model field reference This document contains all the API references of :class:`Field` including the `field options`_ and `field types`_ Django offers. -.. seealso:: - - If the built-in fields don't do the trick, you can try - :pypi:`django-localflavor` (`documentation - `_), which contains assorted - pieces of code that are useful for particular countries and cultures. - - Also, you can easily :doc:`write your own custom model fields - `. - .. note:: Fields are defined in :mod:`django.db.models.fields`, but for convenience 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 `__ -* `Documentation `__ -* :pypi:`PyPI ` - -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 `__ -* `Documentation `__ -* :pypi:`PyPI ` - -Formtools -========= - -``django-formtools`` is a collection of assorted utilities to work with forms. - -* `GitHub `__ -* `Documentation `__ -* :pypi:`PyPI ` 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 ` 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 `_). 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 `_). + .. _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 -- cgit v1.3