Skip to content

Commit

Permalink
fix(org/*): Multiple minor fixes and spotted mistakes
Browse files Browse the repository at this point in the history
After notificng that last edit date doesn't match on some documents,
i noticed small grammar/spelling mistakes, links to non-existing documents,
etc.

Signed-off-by: Denys Fedoryshchenko <[email protected]>
  • Loading branch information
nuclearcat authored and patersonc committed Dec 18, 2024
1 parent cd9a3b0 commit a064c7c
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 38 deletions.
59 changes: 32 additions & 27 deletions kernelci.org/content/en/org/maintainers.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,27 @@
---
title: "Maintainers"
date: 2021-09-23
date: 2024-12-03
description: "KernelCI maintainers"
weight: 5
---

# Roles and Responsibilities of KernelCI Maintainers

There are several types of maintainer roles with different responsibilities:

[software maintainers](#software-maintainers)
[Software Maintainers](#software-maintainers)
: in charge of the KernelCI software components

[service maintainers](#service-maintainers)
[Service Maintainers](#service-maintainers)
: in charge of the KernelCI hosted services

[feature maintainers](#feature-maintainers)
[Feature Maintainers](#feature-maintainers)
: in charge of features that span across the whole KernelCI stack

[instance maintainers](#instance-maintainers)
[Instance Maintainers](#instance-maintainers)
: in charge of a particular KernelCI instance (production, staging...)

[channel maintainers](#channel-maintainers)
[Channel Maintainers](#channel-maintainers)
: in charge of the communication channels used by KernelCI

Most maintainers are members of the [TSC](/org/tsc) but additional people
Expand All @@ -28,15 +30,15 @@ can be involved too.
## Software Maintainers

At least one maintainer is assigned to each software component. The work
involves reviewing pull requests on GitHUb, triaging issue, updating GitHub
settings and facilitating the development workflow. Having “deputy”
involves reviewing pull requests on GitHub, triaging issue, updating GitHub
settings and facilitating the development workflow. Assigning “deputy”
maintainers whenever possible also helps with the continuity of the project
when regular maintainers are not available.

In addition to maintainers for each project, some GitHub administrators are
available to make configuration changes at the organisation level. This
includes managing teams, permissions for each project, adding / moving /
removing projects, configurating workboards and updating any other general
removing projects, configuring workboards and updating any other general
settings.

* Organisation: https://github.com/kernelci
Expand All @@ -49,7 +51,7 @@ some encrypted files and other administrative documents. Therefore it's not
strictly software but has the same requirements from a maintainer point of view.

Please note that other people not listed here might also have access to the
encrypted files for practical resons (shared account passwords, sysadmin
encrypted files for practical reasons (shared account passwords, sysadmin
information etc.).

* Repository: [`kernelci-project`](https://github.com/kernelci/kernelci-project)
Expand Down Expand Up @@ -110,7 +112,7 @@ kci-dev is a command line tool and library for kernel developers and maintainers
> discussion](https://groups.io/g/kernelci/topic/moving_lava_docker_out_of_the/93248754)
> for more details.
This project is to Simplify the installation and maintenance of a LAVA lab
This project aims to simplify the installation and maintenance of a LAVA lab
using Docker containers.

* Repository: [`lava-docker`](https://github.com/kernelci/lava-docker)
Expand All @@ -120,7 +122,7 @@ using Docker containers.

Services hosted by KernelCI all need someone to look after them and ensure they
stay online and available. This is essentially sysadmin work with some code
maintannce too depending on the cases.
maintenance too depending on the cases.

### Kubernetes

Expand All @@ -143,7 +145,7 @@ tools, backups...

### BigQuery

KCIDB uses BigQuery as a database engine. This requires setting up tokens and
KCIDB uses BigQuery as a database engine. This requires token setup and
managing the associated Cloud resources.

* Maintainers: `spbnick`, `khilman`
Expand Down Expand Up @@ -197,27 +199,30 @@ Just like tests, kernel builds orchestrated on kernelci.org are called the
* Maintainers: `broonie`, `nuclearcat`
* Components:
[`kernelci-core/config`](https://github.com/kernelci/kernelci-core/tree/main/config),
[`kernelci-jenkins`](https://github.com/kernelci/kernelci-jenkins)
* Services: Pipeline / Jenkins, Kubernetes

### Bisections
[`kernelci-pipeline/config`](https://github.com/kernelci/kernelci-pipeline/tree/main/config)

For every test regression detected, an automated bisection is run whenever
possible. This involves building kernels, running tests and checking their
results in a coordinated way to then send an email report when the bisection
succeeds.

* Maintainers: `gtucker`
* Components: [`kernelci-core`](https://github.com/kernelci/kernelci-core),
[`bisect.jpl`](https://github.com/kernelci/kernelci-jenkins/blob/main/jobs/bisect.jpl)
* Services: Pipeline / Jenkins
* Services: Pipeline

## Instance maintainers

As there are several KernelCI instances, it's necessary to have people
dedicated to each of them.

> ToDo: Update with new API & Pipeline deployments as they become available.
### Production

The production instance is the main one, hosted at kernelci.org. It is used
for the main KernelCI project and is the one most people are familiar with.

* Maintainers: `nuclearcat`, `pawiecz`


### Staging

The staging instance is used for testing new features before they are deployed
to production. It is also used for training new users and for debugging issues
that are hard to reproduce in production.

* Maintainers: `nuclearcat`, `pawiecz`

## Channel Maintainers

Expand Down
2 changes: 1 addition & 1 deletion kernelci.org/content/en/org/members.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Members"
date: 2021-09-23
date: 2024-12-03
description: "Member companies who fund the KernelCI project"
weight: 1
---
Expand Down
14 changes: 4 additions & 10 deletions kernelci.org/content/en/org/working-groups.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Working groups"
date: 2024-02-19
date: 2024-12-03
description: "KernelCI Working Groups"
weight: 4
---
Expand Down Expand Up @@ -53,6 +53,7 @@ potentially a new design from scratch using modern web technology.
* [Mark Brown](mailto:<[email protected]>) - `broonie`
* [Nikolai Kondrashov](mailto:<[email protected]>) - `spbnick`
* [Vince Hillier](mailto:<[email protected]>) - `vince`
* [Paweł Wieczorek](mailto:<[email protected]>) - `pawiecz`

The KernelCI common infrastructure requires some regular maintenance to keep
web servers, databases and Cloud services up and running. This does not
Expand All @@ -63,19 +64,12 @@ As per the [2022-12-08 TSC vote](/org/tsc/votes/#2022-12-08), admin rights
cover the following items:

* Machines (SSH, sudo):
* KernelCI staging VM
* KernelCI production VM
* Jenkins runner nodes
* Azure VMs
* Kubernetes nodes

* Web applications:
* Staging Jenkins instance (admin access)
* Production Jenkins instance (admin access)
* SysAdmin GitHub project board
* Azure portal (admin access)
* Encrypted repositories:
* kernelci-jenkins-data
* builder-config-data

This group has a large overlap with [service
maintainers](tsc/#service-maintainers), it's merely a way to facilitate
operations and ensure maintenance is taking place.

0 comments on commit a064c7c

Please sign in to comment.