docs icon indicating copy to clipboard operation
docs copied to clipboard

docs/philosophy: Initial commit

Open RichiH opened this issue 7 years ago • 6 comments

This was surprisingly hard; I went through several iterations, tossing things away, re-adding some, and refactoring into different files. On the plus side, I think what I have is already relatively cleanly separated. design & patterns is a collection of half-finished thoughts and sentences with tons of duplicates. No use pushing those atm.

I would be especially interested in large conceptual comments and missing sections, less so in specific wording as that is bound to change, yet again, once there's more content.

RichiH avatar Jun 10 '18 11:06 RichiH

I agree that it still lacks a consistent thread, but I figured I'd rather get partial feedback at this point to align.

RichiH avatar Jun 10 '18 12:06 RichiH

Are there any major sections & content missing from philosophy and goals?

What I am missing, on purpose, are any cross-links, those will come last.

Anything we can reasonably push to a lower tier, we should push there.

RichiH avatar Jun 10 '18 13:06 RichiH

Are there any major sections & content missing from philosophy and goals?

Have you intentionally omitted most of the points from https://github.com/prometheus/docs/issues/149 so far?

juliusv avatar Jun 10 '18 16:06 juliusv

@roidelapluie I do, it's on my bucket lest, thanks!

RichiH avatar Feb 13 '20 14:02 RichiH

@RichiH , this PR seems to get some love on the mailing list. I guess to revive it, it needs first an update from your side before it makes sense for reviewers to comment on details.

beorn7 avatar Mar 17 '20 13:03 beorn7

@RichiH Any updates here? I think it would be great to get this in in some form.

grobie avatar Oct 15 '20 17:10 grobie