[Django] #26714: Documentation for Geographic Sitemaps is empty

22 views
Skip to first unread message

Django

unread,
Jun 6, 2016, 2:15:02 PM6/6/16
to django-...@googlegroups.com
#26714: Documentation for Geographic Sitemaps is empty
--------------------------------------+----------------------------------
Reporter: lordgordon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: GIS | Version: master
Severity: Normal | Keywords: sitemaps, KMLSitemap
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+----------------------------------
Hi there,

I found a part of the documentation for GeoDjango completely empty:
https://docs.djangoproject.com/en/1.9/ref/contrib/gis/sitemaps/.

The related file in the repository is empty too, so is not an issue in the
generated doc:
https://github.com/django/django/blob/stable/1.10.x/docs/ref/contrib/gis/sitemaps.txt

The status of this file is the same in the master tree, as well in 1.9 and
1.10 branches. A quick look in trac doesn't show any ticket about this
issue.

Best Regards,

Nicholas

--
Ticket URL: <https://code.djangoproject.com/ticket/26714>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Jun 6, 2016, 2:24:25 PM6/6/16
to django-...@googlegroups.com
#26714: Documentation for Geographic Sitemaps is poor
-------------------------------------+-------------------------------------
Reporter: lordgordon | Owner: nobody
Type: | Status: new
Cleanup/optimization |
Component: GIS | Version: master
Severity: Normal | Resolution:
Keywords: sitemaps, | Triage Stage:
KMLSitemap | Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by lordgordon):

* needs_better_patch: => 0
* needs_docs: => 0
* needs_tests: => 0


Old description:

> Hi there,
>
> I found a part of the documentation for GeoDjango completely empty:
> https://docs.djangoproject.com/en/1.9/ref/contrib/gis/sitemaps/.
>
> The related file in the repository is empty too, so is not an issue in
> the generated doc:
> https://github.com/django/django/blob/stable/1.10.x/docs/ref/contrib/gis/sitemaps.txt
>
> The status of this file is the same in the master tree, as well in 1.9
> and 1.10 branches. A quick look in trac doesn't show any ticket about
> this issue.
>
> Best Regards,
>
> Nicholas

New description:

Hi there,

I found a part of the documentation for GeoDjango mostly empty:
https://docs.djangoproject.com/en/1.9/ref/contrib/gis/sitemaps/.

The abovementioned page lacks of example and details on how
{{{KMLSitemap}}} and {{{KMZSitemap}}} works.

The related file in the repository is empty too, so is not an issue in the
generated doc:
https://github.com/django/django/blob/stable/1.10.x/docs/ref/contrib/gis/sitemaps.txt

The status of this file is the same in the master tree, as well in 1.9 and
1.10 branches. A quick look in trac doesn't show any ticket about this
issue.

Best Regards,

Nicholas

--

--
Ticket URL: <https://code.djangoproject.com/ticket/26714#comment:1>

Django

unread,
Jun 6, 2016, 9:48:32 PM6/6/16
to django-...@googlegroups.com
#26714: Add examples for KMLSitemap and KMZSitemap
--------------------------------------+------------------------------------

Reporter: lordgordon | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: GIS | Version: master
Severity: Normal | Resolution:
Keywords: sitemaps, KMLSitemap | Triage Stage: Accepted

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by timgraham):

* stage: Unreviewed => Accepted


--
Ticket URL: <https://code.djangoproject.com/ticket/26714#comment:2>

Django

unread,
Sep 21, 2026, 10:10:27 AM (3 days ago) Sep 21
to django-...@googlegroups.com
#26714: Add examples for KMLSitemap and KMZSitemap
--------------------------------------+------------------------------------
Reporter: Nicholas Fiorentini | Owner: kosc
Type: Cleanup/optimization | Status: assigned
Component: GIS | Version: dev
Severity: Normal | Resolution:
Keywords: sitemaps, KMLSitemap | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by kosc):

* has_patch: 0 => 1
* owner: nobody => kosc
* status: new => assigned

Comment:

[https://github.com/django/django/pull/22011 PR]

Added examples and reference documentation for KMLSitemap and KMZSitemap.
Documentation build and checks passed. Verified the examples and the GIS
sitemap test with SpatiaLite. Full default SQLite test run on Python 3.14:
19,849 tests, OK (1,414 skipped, 4 expected failures). AI assistance is
disclosed in the PR; the documentation and examples have been manually
reviewed.
--
Ticket URL: <https://code.djangoproject.com/ticket/26714#comment:3>

Django

unread,
Sep 21, 2026, 10:13:37 AM (3 days ago) Sep 21
to django-...@googlegroups.com
#26714: Add examples for KMLSitemap and KMZSitemap
--------------------------------------+------------------------------------
Reporter: Nicholas Fiorentini | Owner: kosc
Type: Cleanup/optimization | Status: assigned
Component: GIS | Version: dev
Severity: Normal | Resolution:
Keywords: sitemaps, KMLSitemap | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Comment (by kosc):

[https://github.com/django/django/pull/22012 PR] replaces #22011. The
original PR was automatically closed before this ticket was assigned, and
GitHub did not permit reopening it. The replacement contains the same
commit.
--
Ticket URL: <https://code.djangoproject.com/ticket/26714#comment:4>
Reply all
Reply to author
Forward
0 new messages