The Zen of Prometheus by kakkoyun · Pull Request #1783 · prometheus/docs

kakkoyun · 2020-11-04T10:24:30Z

Signed-off-by: Kemal Akkoyun kakkoyun@gmail.com

As suggested and discussed on #1692, I would like to make The Zen of Prometheus an official part of documentation.

It would be great if you could help me to refine it by your reviews
@brian-brazil @beorn7 @SuperQ @juliusv @brancz @bwplotka @RichiH

Fix #1692

beorn7

I like the idea of adding this here a lot.

Of course, the original idea had a humorous touch and was meant to be taken with a grain of salt. As an "official" statement here on the project's website it will receive quite a lot of scrutiny…

beorn7 · 2020-11-04T14:29:55Z

+
+The First and the most important rule, if you have to remember only one thing remember this one. Instrument all the things!
+
+## Measure what users care


… care about?

jan--f · 2026-01-27T16:33:16Z

@kakkoyun This got positiv initial feedback! Any interest in still pursuing this?

kakkoyun · 2026-01-27T17:58:45Z

@kakkoyun This got positiv initial feedback! Any interest in still pursuing this?

Alright. I totally forgotten about this. I will definitely love to this lands officially.

I will pursue this.

(p.s: @jan--f I love how you keep snipping me to wrap up the work 😅 Keep them coming, of course if you don't mind)

Signed-off-by: Kemal Akkoyun <kakkoyun@gmail.com>

Signed-off-by: Kemal Akkoyun <kemal.akkoyun@datadoghq.com>

beorn7

Thanks for picking this up again. Some thoughts.

Signed-off-by: Kemal Akkoyun <kemal.akkoyun@datadoghq.com>

beorn7 · 2026-02-17T12:47:21Z

Is this ready for the next round of reviews?

kakkoyun · 2026-02-17T13:51:08Z

Is this ready for the next round of reviews?

I want to check it one last time. Before ping you. It shouldn't take too long. However, feel free to have a look if you have free cycle. Thank you so much.

beorn7 · 2026-02-17T13:55:42Z

if you have free cycle

That's a big "if".

I'll rather wait for your 🛎️ .

kakkoyun · 2026-03-03T16:49:50Z

@beorn7 this is ready for another round. I hope you could find some time. I would be more than happy to continue iterating on this, but I don't want to waste your time. Feel free to suggest me concrete edit if you have clear vision on it.

beorn7 · 2026-03-11T17:53:35Z

Sorry for delay. This is still on my list.

beorn7

Modulo spelling nit, this looks good to me.

As nobody else has chimed in in a while, I guess you could just merge. This is documentation. Improving it incrementally is easy.

Co-authored-by: Björn Rabenstein <github@rabenste.in> Signed-off-by: Kemal Akkoyun <kakkoyun@users.noreply.github.com>

jan--f

Awesome! Thanks @kakkoyun and @beorn7!

@beorn7

Bump publishDate to 2026-05-15 so the post lands on the planned date. Add a special thanks to @beorn7 for the reviews on the docs PR (prometheus/docs#1783) that brought The Zen of Prometheus into the official documentation. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt

@beorn7

* post: celebrate the Zen of Prometheus joining the official docs A reflection on the 2020 PromCon Online talk being adopted at prometheus.io/docs/practices/the_zen/ — gratitude to the Prometheus community for treating best practices as a living document. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt * post: clean prose lint findings and unblock external link check Address Vale findings (Slop.Vocabulary "ecosystem", em-dash density, write-good.So/TooWordy/Weasel) and switch two root-relative /talks/ links to absolute https://kakkoyun.me/ URLs so lychee's new-content check can parse them — the links-new-content workflow does not pass --base, so root-relative paths fail URI parsing. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt * post: trim back-to-back triads per prose review Address the advisory prose review on PR #133: collapse the two triadic structures in the Thanks paragraph (stewarding/keeping/making, shared/asked/pushed) and the "kept linking, kept asking, kept finding" triad earlier in the post. Verdict was ship-ready; this just lifts the cadence. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt * post: schedule for 2026-05-15, thank @beorn7, link merged docs PR Bump publishDate to 2026-05-15 so the post lands on the planned date. Add a special thanks to @beorn7 for the reviews on the docs PR (prometheus/docs#1783) that brought The Zen of Prometheus into the official documentation. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt * post: use the-zen screenshots as cover and inline visual Swap the YouTube thumbnail cover for the new docs page screenshot (the-zen-now.png) — the post's actual subject. Add an inline screenshot of the original Zen of Prometheus netlify site in "Where it started", so the chronological reveal lands visually as well as in prose. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt * post: credit @jessicalins for the PromCon EU 2022 follow-up Replace the generic "co-speaker" reference with @jessicalins by name, linking her GitHub profile. She was the partner in crime on the 2022 PromCon EU follow-up that carried the same thread further. https://claude.ai/code/session_01ACPk7x2v9siXdisu8vH7Pt --------- Co-authored-by: Claude <noreply@anthropic.com>

brian-brazil reviewed Nov 4, 2020

View reviewed changes

beorn7 suggested changes Nov 4, 2020

View reviewed changes

kakkoyun and others added 2 commits January 27, 2026 21:34

Initialize The Zen of Prometheus

9ce52ae

Signed-off-by: Kemal Akkoyun <kakkoyun@gmail.com>

docs(practices): address review comments on The Zen of Prometheus

0a06fd3

Signed-off-by: Kemal Akkoyun <kemal.akkoyun@datadoghq.com>

kakkoyun force-pushed the the_zen_of_prometheus branch from 0c486a9 to 0a06fd3 Compare January 27, 2026 21:20

kakkoyun requested a review from beorn7 January 27, 2026 21:26

docs(practices): add native histograms guidance

58c046a

Signed-off-by: Kemal Akkoyun <kemal.akkoyun@datadoghq.com>

beorn7 suggested changes Jan 28, 2026

View reviewed changes

chore: address review comments

9a3d311

Signed-off-by: Kemal Akkoyun <kemal.akkoyun@datadoghq.com>

kakkoyun requested a review from beorn7 March 3, 2026 16:49

beorn7 previously approved these changes Mar 17, 2026

View reviewed changes

Comment thread docs/practices/the_zen.md Outdated

Update docs/practices/the_zen.md

e728fa3

Co-authored-by: Björn Rabenstein <github@rabenste.in> Signed-off-by: Kemal Akkoyun <kakkoyun@users.noreply.github.com>

kakkoyun dismissed beorn7’s stale review via e728fa3 March 17, 2026 16:38

Merge branch 'main' into the_zen_of_prometheus

7ea5eab

jan--f approved these changes Mar 17, 2026

View reviewed changes

jan--f merged commit 0dcc18e into prometheus:main Mar 17, 2026
6 checks passed

kakkoyun deleted the the_zen_of_prometheus branch March 18, 2026 11:12


		The First and the most important rule, if you have to remember only one thing remember this one. Instrument all the things!

		## Measure what users care

Uh oh!

Conversation

kakkoyun commented Nov 4, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

beorn7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

beorn7 Nov 4, 2020

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jan--f commented Jan 27, 2026

Uh oh!

kakkoyun commented Jan 27, 2026

Uh oh!

beorn7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

beorn7 commented Feb 17, 2026

Uh oh!

kakkoyun commented Feb 17, 2026

Uh oh!

beorn7 commented Feb 17, 2026

Uh oh!

kakkoyun commented Mar 3, 2026

Uh oh!

beorn7 commented Mar 11, 2026

Uh oh!

beorn7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jan--f left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

kakkoyun commented Nov 4, 2020 •

edited

Loading