Fix: UUIDExtension docs had stale version 1.x instead of actual 2.0

The Bug

Repo: cookiecutter/cookiecutter Issue: Documentation version tag — *New in Cookiecutter 1.x* on line 132 of docs/advanced/template_extensions.rst Status: PR-submitted PR: https://github.com/cookiecutter/cookiecutter/pull/2235

Description: The UUID4 extension documentation had a stale 1.x version tag that was never updated to the actual release version.

Fix scope: 1 line changed in docs/advanced/template_extensions.rst

Root Cause

This is a documentation artifact that survived from initial development. The UUIDExtension class was added in PR #1493 by @jonaswre (commit 8fc8560, April 2021), and shipped in the 2.0.1 release — confirmed by its entry in CHANGELOG/2.0.1.md [1]:

Added uuid extension to be able to generate uuids (#1493) @jonaswre

The “New in” tag was written as *New in Cookiecutter 1.x* — a template pattern that should have been replaced with the actual version during the 2.0 release cycle.

The Fix

@@ -129,7 +129,7 @@
 UUID4 extension
 ~~~~~~~~~~~~~~~~~~~~~~~

-*New in Cookiecutter 1.x*
+*New in Cookiecutter 2.0*

 The ``cookiecutter.extensions.UUIDExtension`` extension provides a ``uuid4()``
 method in templates that generates a uuid4.

How We Verified the Correct Version

Three independent sources confirmed the fix:

1. Git history: git log -S UUIDExtension -- cookiecutter/extensions.py → commit 8fc8560 (“Added uuid extension to be able to generate uuids (#1493)”) [1]
2. CHANGELOG: CHANGELOG/2.0.1.md explicitly lists the UUID extension as a new feature [1]
3. Other extensions in same file: Every other extension has a specific version (1.4, 1.7) — only UUID had the stale tag

Pattern: Stale Version Tag Detection

This class of bug — version tags and feature markers that ship with stale values — is common in documentation. A quick audit pattern:

# Find version tags with non-specific versions in docs
rg -rn 'New in.*(x|X|\.\.)' docs/

# Find stale markers in any project
rg -rn '1\.x|2\.x|X\.x' docs/

Run this across any project with versioned feature documentation. Stale tags erode reader trust — if the version is wrong, what else is outdated?

Transfer Potential

High — the detection pattern applies to any project with versioned docs. The fix itself is trivial; the value is in the audit.

Sources

[1] cookiecutter/cookiecutter CHANGELOG/2.0.1.md — UUID extension addition confirmed in 2.0.1 release notes.

---

Auto-generated from PR #2235. View all patches on GitHub.