Skip to content

Doc: Track file downloads via plausible#138393

Merged
hugovk merged 3 commits intopython:mainfrom
JacobCoffee:plausible-docs-download-tracking
Sep 2, 2025
Merged

Doc: Track file downloads via plausible#138393
hugovk merged 3 commits intopython:mainfrom
JacobCoffee:plausible-docs-download-tracking

Conversation

@JacobCoffee
Copy link
Member

@JacobCoffee JacobCoffee commented Sep 2, 2025 •
edited
Loading

Trivial change to track zip files downloaded from https://docs.python.org/3/download.html
on our Plausible instance for docs: https://analytics.python.org/docs.python.org

ref: https://plausible.io/docs/file-downloads-tracking, https://hackmd.io/_vyolH-NR3GQHoOUjqdzuQ

We may want to add file-types="zip, bz2" if we also want the bz2 packed files? (ref: https://plausible.io/docs/file-downloads-tracking#which-file-types-are-tracked)

📚 Documentation preview 📚: https://cpython-previews--138393.org.readthedocs.build/

@AA-Turner AA-Turner changed the title feat(docs): track downloads via plausible Doc: Track file downloads via plausible Sep 2, 2025
@AA-Turner AA-Turner added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Sep 2, 2025
@AA-Turner
Copy link
Member

AA-Turner commented Sep 2, 2025

We may want to add file-types="zip, bz2" if we also want the bz2 packed files? (ref: plausible.io/docs/file-downloads-tracking#which-file-types-are-tracked)

Please.

A

hugovk
hugovk approved these changes Sep 2, 2025
View reviewed changes
Copy link
Member

@hugovk hugovk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Let's check this works on main = https://docs.python.org/dev/ before backporting.

@JacobCoffee
Copy link
Member Author

JacobCoffee commented Sep 2, 2025

@AA-Turner done!

@hugovk
Copy link
Member

hugovk commented Sep 2, 2025

Oh and let's include .epub:

https://docs.python.org/3/archives/python-3.13-docs.epub

AA-Turner
AA-Turner reviewed Sep 2, 2025
View reviewed changes
@JacobCoffee @AA-Turner
Update Doc/tools/templates/layout.html
5b063fc 
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@hugovk hugovk merged commit e4e2390 into python:main Sep 2, 2025
27 checks passed
@miss-islington-app
Copy link

miss-islington-app bot commented Sep 2, 2025

Thanks @JacobCoffee for the PR, and @hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Sep 2, 2025
@JacobCoffee @AA-Turner @miss-islington
Doc: Track file downloads via plausible (pythonGH-138393)
40b5229 
(cherry picked from commit e4e2390)

Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Sep 2, 2025
@JacobCoffee @AA-Turner @miss-islington
Doc: Track file downloads via plausible (pythonGH-138393)
1291fcd 
(cherry picked from commit e4e2390)

Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@bedevere-app
Copy link

bedevere-app bot commented Sep 2, 2025

GH-138396 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.14 bugs and security fixes label Sep 2, 2025
@bedevere-app
Copy link

bedevere-app bot commented Sep 2, 2025

GH-138397 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label Sep 2, 2025
@hugovk
Copy link
Member

hugovk commented Sep 2, 2025

It's working :)

image

https://analytics.python.org/docs.python.org?f=is,goal,File%20Download

Or https://analytics.python.org/docs.python.org > Goal Conversions > File Download

hugovk pushed a commit that referenced this pull request Sep 2, 2025
@miss-islington @JacobCoffee @AA-Turner
[3.14] Doc: Track file downloads via plausible (GH-138393) (#138396)
5c47d72 
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
hugovk pushed a commit that referenced this pull request Sep 2, 2025
@miss-islington @JacobCoffee @AA-Turner
[3.13] Doc: Track file downloads via plausible (GH-138393) (#138397)
3a2e436 
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
kumaraditya303 pushed a commit to miss-islington/cpython that referenced this pull request Sep 9, 2025
@miss-islington @JacobCoffee
@AA-Turner @kumaraditya303
[3.14] Doc: Track file downloads via plausible (pythonGH-138393) (pyt…
959fb62 
…hon#138396)

Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
lkollar pushed a commit to lkollar/cpython that referenced this pull request Sep 9, 2025
@JacobCoffee @AA-Turner @lkollar
Doc: Track file downloads via plausible (python#138393)
a148a04 
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
@hugovk hugovk mentioned this pull request Dec 7, 2025
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@AA-Turner AA-Turner AA-Turner approved these changes

@hugovk hugovk hugovk approved these changes

@StanFromIreland StanFromIreland StanFromIreland approved these changes

Assignees

No one assigned

Labels

skip issue skip news

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@JacobCoffee @AA-Turner @hugovk @StanFromIreland