Skip to content

Conversation

bwplotka
Copy link
Member

@bwplotka bwplotka commented Jun 10, 2024

This section will contain specs used by more projects than just Prometheus server e.g. RW protocols.

Exposition formats are for now in https://prometheus.io/docs/introduction/overview/ but one idea is to mention those there but have full specs in this new section.

Used unlock icon - I like the intention of not-locking the ecosystem with OSS specs and standards. Also considered: bullhorn icon (important? announced loud?), certificate (kind of official, but icon does not look like cert really), globe (aka connecting the world) and users (aka connecting ppl).

I ensured https://prometheus.io/docs/concepts/remote_write_spec/ link still will works (check https://deploy-preview-2474--prometheus-docs.netlify.app/docs/concepts/remote_write_spec/)

image

@juliusv
Copy link
Member

juliusv commented Jun 10, 2024

Thanks! I think the section should be sorted to the very bottom though. That's because it's only for the real developer insiders who want to implement one of these specifications, and normal users should not have to ever deal with technical specification details (as great as it is to have them). So we should get it out of the way of the normal user journey as much as possible.

For the section icon, to me all the ones you listed already have such strong other connotations that they don't really fit for me 🙈 When I think about specifications, I think about long detailed documents, so how about file-text or file-text-o from https://fontawesome.com/v4/icons/?

Signed-off-by: bwplotka <bwplotka@gmail.com>
@juliusv
Copy link
Member

juliusv commented Jun 10, 2024

👍 Thanks :)

@juliusv juliusv merged commit ade0258 into main Jun 10, 2024
@juliusv juliusv deleted the spec branch June 10, 2024 10:47
@bwplotka
Copy link
Member Author

Sounds fair to me, adjusted. I used file-text-o as it looks better (to me) next to the darker book icon for tutorials.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants