github.com/thanos-io/thanos@v0.32.5/docs/proposals-done/202106-proposals-process.md (about)

     1  ---
     2  type: proposal
     3  title: Proposal Process
     4  status: complete
     5  owner: bwplotka
     6  menu: proposals-done
     7  ---
     8  
     9  # 2021-06: Proposal Process
    10  
    11  * **Owners:**:
    12    * [`@bwplotka`](https://github.com/bwplotka)
    13  
    14  * **Other docs:**
    15    * [KEP Process](https://github.com/kubernetes/enhancements/blob/master/keps/README.md)
    16    * [RHOBS Handbook Proposal Process](https://github.com/rhobs/handbook/pull/15)
    17  
    18  > TL;DR: We would like to propose an improved, official proposal process for Thanos that clearly states when, where and how to create proposal/enhancement/design documents. We propose to store done, accepted and rejected proposals in markdown in the main Thanos repo.
    19  
    20  ## Why
    21  
    22  More extensive architectural, process, or feature decisions are hard to explain, understand and discuss. It takes a lot of time to describe the idea, to motivate interested parties to review it, give feedback and approve. That's why it is essential to streamline the proposal process.
    23  
    24  Given that as open-source community we work in highly distributed teams and work with multiple communities, we need to allow asynchronous discussions. This means it's essential to structure the talks into shared documents. Persisting those decisions, once approved or rejected, is equally important, allowing us to understand previous motivations.
    25  
    26  There is a common saying [`"I've just been around long enough to know where the bodies are buried"`](https://twitter.com/AlexJonesax/status/1400103567822835714). We want to ensure the team related knowledge is accessible to everyone, every day, no matter if the team member is new or part of the team for ten years.
    27  
    28  ### Pitfalls of the current solution
    29  
    30  Thanos process was actually following proposed process. We were just missing written rationales and official template that will make Thanos community easier to propose new ideas and motivate them!
    31  
    32  ## Goals
    33  
    34  Goals and use cases for the solution as proposed in [How](#how):
    35  
    36  * Allow easy collaboration and decision making on design ideas.
    37  * Have a consistent design style that is readable and understandable.
    38  * Ensure design docs are discoverable for better awareness and knowledge sharing about past decisions.
    39  * Define a clear review and approval process.
    40  
    41  ## Non-Goals
    42  
    43  * Define process for other type of documents.
    44  
    45  ## How
    46  
    47  We want to propose an improved, official proposal process for Thanos Community that clearly states *when, where and how* to create proposal/enhancement/design documents.
    48  
    49  See [the process and template defined here](../contributing/proposal-process.md)