Skip to content

Commit b6281d6

Browse files
authored
Merge pull request #1 from bensternthal/patch-1
Update README.md
2 parents d02c16c + 077eaf3 commit b6281d6

File tree

1 file changed

+101
-1
lines changed

1 file changed

+101
-1
lines changed

README.md

Lines changed: 101 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,101 @@
1-
# ceph-committee-template
1+
# Repository Template and Usage Guide
2+
3+
## Summary
4+
5+
This repository is designed to serve as a template for all Ceph committees.
6+
7+
## Repository Naming Convention
8+
9+
To maintain a clear and organized naming system, repositories should follow this convention:
10+
11+
{topic}-committee
12+
13+
For example:
14+
* outreach-committee
15+
* hardware-committee
16+
* governance-committee
17+
18+
This naming convention helps identify the purpose and scope of the repository at a glance.
19+
20+
## Required Contents
21+
22+
Every committee repository must include the following files:
23+
24+
### 1. README.md
25+
26+
The README.md file serves as the repository’s introduction and documentation. It should include:
27+
28+
* The goal of the committee.
29+
* The desired outcomes the committee aims to achieve.
30+
* A list of members involved in the committee, including their roles (e.g., chair).
31+
32+
An example template can be found at the bottom of this README
33+
34+
35+
### 2. LICENSE
36+
37+
The LICENSE.md file specifies the repository’s licensing terms. Apache 2.0 is recommended.
38+
39+
## Objectives & Key Results (OKRs)
40+
41+
While not mandatory, we encourage committees to define and commit to achievable OKRs. These OKRs should follow an
42+
annual cycle and be documented in a file named YYYY-OKRs.md. A template is provided below.
43+
44+
## Visibility
45+
46+
We encourage committees to keep their repositories public. However there might be valid reasons for a repository
47+
needing to be private, when in doubt please ask the board.
48+
49+
## Issues and Github Projects
50+
51+
Committees are encouraged to leverage Github issues and projects to organize and track their work.
52+
53+
54+
## README.md Template
55+
56+
```
57+
# [Committee Name]
58+
59+
## Goal
60+
61+
[A committee’s goal should be a clear, actionable, and purpose-driven statement that aligns with
62+
Ceph's broader mission. It should outline the committee’s desired outcome or contribution. For example:
63+
64+
To ensure the Ceph community can efficiently build, test, and release software by addressing the
65+
bottlenecks in the current build environment, enhancing lab capacity, and diversifying infrastructure
66+
to reduce single points of failure. ]
67+
68+
## Desired Outcomes
69+
70+
[Broadly What the committee aims to achieve. For example:
71+
72+
1. Increased Build Capacity
73+
2. Diversified Infrastructure
74+
3. Optimized Resource Utilization
75+
]
76+
77+
## Committee Members
78+
79+
[A list of who is on the committee and their roles if applicable]
80+
81+
* [First Name, Last Name (@githubid) - Role]
82+
83+
```
84+
85+
## YYYY-OKRs.md Template
86+
87+
```
88+
OKR Template
89+
This template provides a structured way to outline Objectives and Key Results (OKRs) broken down by quarters.
90+
91+
## Q1: [Year]
92+
93+
### Objective 1: [State the high-level goal you want to achieve this quarter.]
94+
95+
### Key Results:
96+
97+
[KR 1: Specific measurable result tied to the objective.]
98+
[KR 2: Specific measurable result tied to the objective.]
99+
[KR 3: Specific measurable result tied to the objective.]
100+
101+
```

0 commit comments

Comments
 (0)