Skip to content

Commit

Permalink
Fix markdown lint errors
Browse files Browse the repository at this point in the history
Co-authored-by: Kristina Devochko <47773700+guidemetothemoon@users.noreply.github.com>
Signed-off-by: Leonard Vincent Simon Pahlke <leonard.pahlke@googlemail.com>
  • Loading branch information
leonardpahlke and guidemetothemoon committed Nov 2, 2023
1 parent aaf9884 commit b2be19d
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 22 deletions.
2 changes: 1 addition & 1 deletion governance/github.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
The main GitHub repository for the TAG is `tag-env-sustainability`. TAG Leads have admin access to the repository and elected leads of working groups and projects maintain access which is defined in the [`cncf/people/config.yaml`](https://github.com/cncf/people/blob/main/config.yaml).

The TAG also has technical repositories.
The [`tag-env-tooling`](https://github.com/cncf-tags/tag-env-tooling) contains smaller project, larger projects get sourced in seperate repsitories.
The [`tag-env-tooling`](https://github.com/cncf-tags/tag-env-tooling) contains smaller projects. Larger projects get sourced in separate repositories.
All technical repositories are maintained in the [`cncf-tags`](https://github.com/cncf-tags) GitHub organization.
See [`cncf-tags`](https://github.com/cncf/toc/blob/main/tags/cncf-tags-github-org.md) to find out more about the intention behind the organization.

Expand Down
32 changes: 16 additions & 16 deletions governance/lead-proposal-process.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,24 +11,24 @@ The election process for Working Group and Project leadership is more lightweigh

- [TAG Leadership election process](#tag-leadership-election-process)
- [TAG Chair and TL election process](#tag-chair-and-tl-election-process)
- [Process of nominations](#process-of-nominations)
- [Community timeline](#community-timeline)
- [Submitting a nomination](#submitting-a-nomination)
- [Process of nominations for TAG Chair and TL](#process-of-nominations-for-tag-chair-and-tl)
- [Community timeline for electing TAG Chair and TL](#community-timeline-for-electing-tag-chair-and-tl)
- [Submitting a nomination for TAG Chair and TL](#submitting-a-nomination-for-tag-chair-and-tl)
- [Additional note about the TAG Chair proposal process](#additional-note-about-the-tag-chair-proposal-process)
- [General nomination requirements](#general-nomination-requirements)
- [Justification for nominees](#justification-for-nominees)
- [Announcing nomination results](#announcing-nomination-results)
- [Next Steps](#next-steps)
- [Working Group and Project Leadership](#working-group-and-project-leadership)
- [Process of nominations](#process-of-nominations-1)
- [Community timeline](#community-timeline-1)
- [Submitting a nomination](#submitting-a-nomination-1)
- [Process of nominations for Working Group and Project Leads](#process-of-nominations-for-working-group-and-project-leads)
- [Community timeline for electing Working Group and Project Leads](#community-timeline-for-electing-working-group-and-project-leads)
- [Submitting a nomination for Working Group and Project Leads](#submitting-a-nomination-for-working-group-and-project-leads)

## TAG Chair and TL election process

### Process of nominations
### Process of nominations for TAG Chair and TL

TAG Lead roles are open to all interested participants within the community.
TAG Lead roles are open to all interested participants within the community.
Depending on the needs of the community, as determined by the current TAG leadership team (Chairs and TLs), nominations may come from working group co-chairs, TAG co-chairs and/or tech leads and/or other community members. Each TAG is expected to define this for themselves.

The TAG ENV leadership team is conducted of:
Expand All @@ -51,7 +51,7 @@ The process of endorsing and selecting individuals will consider the following f

In case there are no individuals expressing interest in taking up leadership positions, an evaluation process for the TAG / working group or project archival may be initiated, as [outlined by the TOC](https://github.com/cncf/toc/blob/main/tags/cncf-tags.md#retirement).

#### Community timeline
#### Community timeline for electing TAG Chair and TL

Community nominations will run for at least 1 month, with a maximum up to 2 months.

Expand All @@ -61,9 +61,9 @@ Community nominations will run for at least 1 month, with a maximum up to 2 mont

Upon close of nominations, a decision should be made within the next month.

#### Submitting a nomination
#### Submitting a nomination for TAG Chair and TL

Nominations are to be submitted to [TAG Co-Chair's email alias](mailto:cncf-tag-env-sus-chairs@lists.cncf.io) with the details:
Nominations are to be submitted to [TAG Co-Chair's email alias](mailto:cncf-tag-env-sus-chairs@lists.cncf.io) with the details:

* Subject `"NOMINATION $(TAG Chair, TAG TL, WG XYZ Chair): $NAME-OF-NOMINEE"`
* CC the nominee
Expand Down Expand Up @@ -118,10 +118,10 @@ If the role under nomination requires TOC approval or vote, the TAG Co-chairs ar

Working group and project leads are appointed by the TAG Chairs through the following process.

### Process of nominations
### Process of nominations for Working Group and Project Leads

TAG Lead roles are open to all interested participants within the community.
There are currently no limits of leadership roles for working groups or projects if not specifed otherwise in the WG / project charter document.
TAG Lead roles are open to all interested participants within the community.
There are currently no limits of leadership roles for working groups or projects if not specifed otherwise in the WG / project charter document.

The process of endorsing and selecting individuals will consider the following factors to ensure both the need for proper community representation and the necessary technical expertise:

Expand All @@ -134,13 +134,13 @@ The process of endorsing and selecting individuals will consider the following f

In case there are no individuals expressing interest in taking up leadership positions, an evaluation process for the working group or project archival may be initiated, as [working group archival process](project-formation.md).

#### Community timeline
#### Community timeline for electing Working Group and Project Leads

Community nominations will run for at least 2 weeks, with a maximum up to 1 months.
The TAG Chairs will take a vote.
Upon close of nominations, a decision should be made within the next month.

#### Submitting a nomination
#### Submitting a nomination for Working Group and Project Leads

One of the TAG Leads will open an issue to initiate the nomination process.
Anyone interested can add a comment to the issue to clearly show interest.
Expand Down
10 changes: 5 additions & 5 deletions governance/project-formation.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,10 +25,10 @@ You can browse existing charter documents for [working-groups here](../working-g

1. **Title and Introduction**: Start with a brief introduction that states the purpose of the document. Mention the project's affiliation, purpose and role under the TAG ENV.
2. **Motivation**: Explain the reasons behind forming the project. Describe the challenges, objectives, and goals it aims to address. Make it clear why the project is necessary and how it supports the broader mission of its parent organization.
3. **Scope**: Define the boundaries of the project's responsibilities. Clearly state what the project will and will not do.
4. **Goals**: List the specific objectives that the project aims to achieve. These should be measurable and related to the overall purpose of the group. Ensure that your goals are aligned with the motivation and scope of the group.
3. **Scope**: Define the boundaries of the project's responsibilities. Clearly state what the project will and will not do.
4. **Goals**: List the specific objectives that the project aims to achieve. These should be measurable and related to the overall purpose of the group. Ensure that your goals are aligned with the motivation and scope of the group.
5. **Non-Goals**: Highlight what the project will not do. These are activities or responsibilities that are outside the group's scope. It's important to make these non-goals explicit to avoid misunderstandings and scope creep.
6. **Deliverables**: Detail what the project will produce or accomplish. Be specific about the expected outcomes and any documentation, tools, or processes that will be created.
6. **Deliverables**: Detail what the project will produce or accomplish. Be specific about the expected outcomes and any documentation, tools, or processes that will be created.

### Finding Leads

Expand All @@ -38,12 +38,12 @@ Roles are described in the [roles](roles.md) document.
* A working group needs to have two or three Chairs. Working group tech leads can be added additionally.
* A project needs to have one or more project leads.

How these leads get elected are defineed in the [lead election](lead-proposal-process.md) document
How these leads get elected are defined in the [lead election](lead-proposal-process.md) document

### Start the Working Group or Project

To start the working group or project open a PR to propose adding the charter document to the TAG repository.
The PR should also update the website and other parts of the repository to record the project accordingly.
The PR should also update the website and other parts of the repository to record the project accordingly.
This [PR](https://github.com/cncf/tag-env-sustainability/pull/151) serves as an example.

## Working Group or Project archival
Expand Down

0 comments on commit b2be19d

Please sign in to comment.