docs: Standardize documentation headings (remove multiple # H1)

- Remove multiple single top-level (# H1) headings per file
 - Use (# H2 and ###### H6) sub-headings for consistency
 - Remove any trailing # in the headings
 - This ensures proper table of contents rendering in MkDocs.

 - Also removed RUN_NR_multiple_BWPs.md as it is moved to MAC usage
This commit is contained in:
Robert Schmidt
2026-01-21 08:33:25 +01:00
committed by Shubhika Garg
parent a9ba6290b9
commit 5c480ffd50
36 changed files with 489 additions and 482 deletions

View File

@@ -4,7 +4,7 @@ review is performed.
[[_TOC_]]
# General
## General
OpenAirInterface employs both human review and automated CI tests to judge
whether a code contribution is ready to be merged.
@@ -25,7 +25,7 @@ There is the official [Gitlab Help](https://docs.gitlab.com/) that can help you
with any questions regarding Gitlab. We recommend reading the [Git
Book](https://git-scm.com/book/en/v2) to use Git properly.
# Basic coding rules
## Basic coding rules
You should respect the `.clang-format` file in the root of the repository. The
`clang-format` tool will pick up this file when being applied to code in the
@@ -64,9 +64,9 @@ document](https://gitlab.eurecom.fr/oai/openairinterface5g/-/wikis/documents/ope
that might be useful; if this document and `.clang-format` contradict,
`.clang-format` takes precedence.
# Main Workflow and Versioning
## Main Workflow and Versioning
## Workflow
### Workflow
You should be familiar with git branching, merging, and rebasing.
@@ -113,7 +113,7 @@ After some time, we make a stable release. For this, we simply merge develop
into master, and give a semantic versioning number, e.g., `v1.1`. We target to
make releases bi-yearly.
## How to manage your own branch
### How to manage your own branch
Before starting to work, please make sure to branch off the latest `develop`
branch. Make commits as appropriate.
@@ -153,7 +153,7 @@ Once you rebased, push the changes to the remote
$ git push origin my-new-feature --force-with-lease # force with lease let's you only overwrite what you also have locally in origin/my-new-feature
```
# Merge Requests
## Merge Requests
A merge request (MR) can be submitted as soon as the code is considered stable
and reviewable. The idea is to start the review early enough so that the code
@@ -215,7 +215,7 @@ during its lifetime in the sidebar on the right. Following options:
- %OK_TO_BE_MERGED: the OAI team plans to merge this; *do not push any changes
anymore at this point*.
# Review Form
## Review Form
The following is a check list that might be used by a reviewer to check that
code contribution fulfils minimum standard w.r.t. formatting, data types,
@@ -244,7 +244,7 @@ Additional optional questions in case they apply:
- Has a new tool/dependency been introduced? Needs to be discussed if to be added.
- Is a new CI test necessary? Can it be done in simulators?
# Reporting bugs
## Reporting bugs
Please report only true bugs in the [issue tracker](../../issues). Do not
report general user problems; use the [mailing