Skip to content

Doc: Track file downloads via plausible #138393

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 3 commits into from
Sep 2, 2025
Merged

Doc: Track file downloads via plausible #138393

merged 3 commits into from
Sep 2, 2025

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

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

@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
@hugovk hugovk merged commit e4e2390 into python:main Sep 2, 2025
27 checks passed
@miss-islington-app
Copy link

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 <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
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 <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
@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 <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
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 <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
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 <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
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 <[email protected]>
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