Opened 10 years ago

Last modified 20 hours ago

#26714 assigned Cleanup/optimization

Add examples for KMLSitemap and KMZSitemap

Reported by: Nicholas Fiorentini Owned by: kosc
Component: GIS Version: dev
Severity: Normal Keywords: sitemaps, KMLSitemap
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Nicholas Fiorentini)

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

Change History (4)

comment:1 by Nicholas Fiorentini, 10 years ago

Description: modified (diff)
Summary: Documentation for Geographic Sitemaps is emptyDocumentation for Geographic Sitemaps is poor

comment:2 by Tim Graham, 10 years ago

Summary: Documentation for Geographic Sitemaps is poorAdd examples for KMLSitemap and KMZSitemap
Triage Stage: UnreviewedAccepted

comment:3 by kosc, 20 hours ago

Has patch: set
Owner: changed from nobody to kosc
Status: newassigned

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.

comment:4 by kosc, 20 hours ago

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.

Note: See TracTickets for help on using tickets.
Back to Top