From 5f10c4fb0aa58d238b425f40c6a4cf91407cc893 Mon Sep 17 00:00:00 2001
From: Timothée Ravier <tim@siosm.fr>
Date: Aug 16 2023 13:41:30 +0000
Subject: *: Fix indentation and whitespace


---

diff --git a/modules/release_guide/pages/beta_RC_compose.adoc b/modules/release_guide/pages/beta_RC_compose.adoc
index 285b77e..b0a6a46 100644
--- a/modules/release_guide/pages/beta_RC_compose.adoc
+++ b/modules/release_guide/pages/beta_RC_compose.adoc
@@ -1,6 +1,6 @@
 include::_partials/attributes.adoc[]
 
-== Beta Release candidate
+= Beta Release candidate
 
 When Quality Engineering (QE) requests a Release Candidate (RC) they do
 so by opening an issue in the releng repository on pagure. Release
@@ -132,7 +132,7 @@ If the compose fails with a directory missing error, then create the
 compose directory with `mkdir /mnt/koji/compose/{branched}`
 ====
 
-==== Syncing the Compose
+=== Syncing the Compose
 
 We sync the compose to `/pub/alt/stage` to enable faster access to new
 content for QA and the larger Fedora community.
@@ -205,7 +205,7 @@ $ sudo -u ftpsync chmod 755 /pub/alt/stage/{branched}_[release_label]-[#.#]
 Once the compose and sync is complete the issue in pagure should be
 updated and closed.
 
-==== Verification
+=== Verification
 
 The method for verifying a compose has completed is checking
 `/mnt/koji/compose/{branched}/[compose_dir]/STATUS`. Any status
diff --git a/modules/release_guide/pages/beta_freeze.adoc b/modules/release_guide/pages/beta_freeze.adoc
index 1a0b165..22a5493 100644
--- a/modules/release_guide/pages/beta_freeze.adoc
+++ b/modules/release_guide/pages/beta_freeze.adoc
@@ -1,16 +1,16 @@
 include::_partials/attributes.adoc[]
 
-== Beta freeze and Bodhi Activation Point
+= Beta freeze and Bodhi Activation Point
 
-=== Description
+== Description
 
 Bodhi must be activated after two weeks of
 https://docs.pagure.org/releng/sop_mass_branching.html[Mass Branching]
 at 14:00 UTC.
 
-=== Action
+== Action
 
-==== Making koji changes
+=== Making koji changes
 
 Make the following koji tag changes
 
@@ -27,7 +27,7 @@ $ koji add-tag-inheritance f{branched}-override f{branched}-updates
 $ koji edit-tag --perm=admin f{branched}
 ....
 
-==== Update bodhi rpm release
+=== Update bodhi rpm release
 
 Set the bodhi rpm to release to not to automatically create the update
 and also bodhi knows to compose the updates
@@ -37,7 +37,7 @@ and also bodhi knows to compose the updates
 $ bodhi releases edit --name "F{branched}" --stable-tag f{branched}-updates --testing-repository updates-testing --package-manager dnf --no-create-automatic-updates --composed-by-bodhi --state frozen
 ....
 
-==== Add the modular release
+=== Add the modular release
 
 Run the following command on your own workstation to add the modular
 release
@@ -69,7 +69,8 @@ ansible
 
 === Update all relevant projects in ansible
 As in https://pagure.io/fedora-infra/ansible/pull-request/1327[this Ansible Pull request] create changes for the {branched} release
-==== Run the playbooks
+
+=== Run the playbooks
 
 ....
 $ rbac-playbook openshift-apps/greenwave.yml
@@ -98,7 +99,7 @@ $ sudo systemctl restart fm-consumer@config
 $ sudo systemctl restart koji-sync-listener
 ....
 
-==== Send Announcement
+=== Send Announcement
 
 Email *devel-announce* and *test-announce* lists about Bodhi Activation.
 Please find the body of the email in templates dir in https://pagure.io/releng/blob/main/f/mail-templates/04-beta-freeze.txt[releng repository]
@@ -143,10 +144,8 @@ $ sudo -u apache bodhi-push --builds '<nvr1>,<nvr2>,...' --username <username>
 ....
 
 
-=== Consider Before Running
+== Consider Before Running
 
 No considerations at this time. The docs git repository is simply a
 static html hosting space and we can just re-render the docs and push to
 it again if necessary.
-
-
diff --git a/modules/release_guide/pages/beta_release.adoc b/modules/release_guide/pages/beta_release.adoc
index 987546b..e0405a0 100644
--- a/modules/release_guide/pages/beta_release.adoc
+++ b/modules/release_guide/pages/beta_release.adoc
@@ -1,9 +1,10 @@
 include::_partials/attributes.adoc[]
 
-== Fedora Beta Release
+= Fedora Beta Release
+
 Based on the GO/NOGO meeting if the currnet compose is GO. The following steps need to be taken.
 
-=== Koji changes
+== Koji changes
 
 [source,subs="attributes+"]
 ....
@@ -11,7 +12,7 @@ $ koji clone-tag --all --latest-only f{branched} f{branched}-Beta
 $ koji clone-tag --all --latest-only f{branched}-modular f{branched}-Beta-modular
 ....
 
-=== Stage release to mirrors
+== Stage release to mirrors
 
 [source,subs="attributes+"]
 ....
@@ -26,7 +27,7 @@ Make sure to grab the directory size usage numbers which is used to send
 an email to [.title-ref]#mirror-admin@lists.fedoraproject.org# list.
 ====
 
-=== Sync the signed checksums to stage
+== Sync the signed checksums to stage
 
 We need to sync the signed checksums to /pub/alt/stage/ by running the
 following command
@@ -36,14 +37,14 @@ following command
 $ for dir in Cloud Container Everything Kinoite Labs Modular Sericea Server Silverblue Spins Workstation metadata; do sudo -u ftpsync rsync -avhH /mnt/koji/compose/{branched}/Fedora-{branched}-20221105.0/compose/$dir/ /pub/alt/stage/{branched}_RC-1.7/$dir/ --link-dest=/pub/fedora/linux/releases/{branched}/Everything/ --link-dest=/pub/alt/stage/{branched}_RC-1.2/Everything/ --link-dest=/pub/alt/stage/{branched}_RC-1.3/Everything --link-dest=/pub/alt/stage/{branched}_RC-1.4/Everything --link-dest=/pub/alt/stage/{branched}_RC-1.5/Everything --link-dest=/pub/alt/stage/{branched}_RC-1.6/Everything --link-dest=/pub/alt/stage/{branched}_RC-1.7/Everything; done
 ....
 
-=== Set release in Bodhi to pending
+== Set release in Bodhi to pending
 
 [source,subs="attributes+"]
 ....
 $ bodhi releases edit --name F{branched} --state pending
 ....
 
-=== Lift RelEng freeze
+== Lift RelEng freeze
 
 Lift the RelEng Freeze so that the updates will be pushed to stable.
 This is done by editing
@@ -52,11 +53,11 @@ variable] in infra ansible repo and then run the bodhi playbook.
 Set also https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/vars/all/FedoraBranchedBodhi.yaml[FedoraBranchedBodhi
 variable] to postbeta
 
-=== Beta Installation and Cleanup
+== Beta Installation and Cleanup
 
 This section outlines the steps that should be followed to ensure that older copies of Fedora betas are removed from the servers and that the correct permissions are set on the directories.
 
-==== Remove older betas
+=== Remove older betas
 
 This cleanup step is to remove the older betas from the `/pub/fedora-secondary/releases/test` and `/pub/fedora/linux/releases/test/` directories. This can be done using the rm command:
 
@@ -68,7 +69,7 @@ $ rm -rf /pub/fedora/linux/releases/test/{branched}_Beta
 
 Note that {branched} should be replaced with the name of the beta release, such as 36_Beta, 37_Beta, etc.
 
-==== Set correct permissions
+=== Set correct permissions
 
 This step is to set the correct permissions on the directories. This can be done using the chmod command:
 
diff --git a/modules/release_guide/pages/final_RC_compose.adoc b/modules/release_guide/pages/final_RC_compose.adoc
index d8c9a4d..58daad8 100644
--- a/modules/release_guide/pages/final_RC_compose.adoc
+++ b/modules/release_guide/pages/final_RC_compose.adoc
@@ -1,4 +1,4 @@
 include::_partials/attributes.adoc[]
 
-== Final Release candidate
+= Final Release candidate
 
diff --git a/modules/release_guide/pages/final_freeze.adoc b/modules/release_guide/pages/final_freeze.adoc
index 4df6bf2..87e37cd 100644
--- a/modules/release_guide/pages/final_freeze.adoc
+++ b/modules/release_guide/pages/final_freeze.adoc
@@ -1,16 +1,16 @@
 include::_partials/attributes.adoc[]
 
-== Fedora Final Freeze
+= Fedora Final Freeze
 
 Before freezing everything we need to do the last stable push in bodhi.
 
-=== Stable push
+== Stable push
 
 ....
 $sudo -u apache bodhi-push --releases --stable '{branched},{branched}M'
 ....
 
-=== Ansible changes
+== Ansible changes
 
 Freeze is enabled by editing
 https://infrastructure.fedoraproject.org/cgit/ansible.git/tree/vars/all/RelEngFrozen.yaml[RelEngFrozen
@@ -20,10 +20,10 @@ variable] in infra ansible repo and then run the bodhi playbook.
 $ sudo rbac-playbook groups/bodhi-backend.yml
 ....
 
+== Update bodhi release
 
-=== Update bodhi release
 ....
 $ bodhi releases edit --name {branched} --state frozen
 ....
 
-=== Process stable push requests
\ No newline at end of file
+== Process stable push requests
diff --git a/modules/release_guide/pages/final_release.adoc b/modules/release_guide/pages/final_release.adoc
index 77c8c20..2257a4f 100644
--- a/modules/release_guide/pages/final_release.adoc
+++ b/modules/release_guide/pages/final_release.adoc
@@ -1,20 +1,20 @@
 include::_partials/attributes.adoc[]
 
-== Fedora Final Release
+= Fedora Final Release
 
-=== Update FedoraPreviousPrevious.yaml in ansible repository
+== Update FedoraPreviousPrevious.yaml in ansible repository
 
 set the https://pagure.io/fedora-infra/ansible/blob/main/f/vars/all[variable] to True in ansible repository.
 
+== Koji changes
 
-=== Koji changes
 [source,subs="attributes+"]
 ....
 $ koji edit-tag --lock f{branched}
 $ koji edit-tag --lock f{branched}-modular
 ....
 
-=== Bodhi Changes
+== Bodhi Changes
 
 Set the bodhi release to `current`
 [source,subs="attributes+"]
@@ -31,7 +31,7 @@ $ bodhi releases edit --name F{old_release}F --eol YYYY-MM-DD
 $ bodhi releases edit --name F{old_release}M --eol YYYY-MM-DD
 ....
 
-=== Disable Branched Compose
+== Disable Branched Compose
 
 Now that we have a final GOLD compose, we dont need nightly branched
 composes anymore. This is disabled in
@@ -42,7 +42,7 @@ role] in infra ansible repo and then running the playbook.
 $ sudo rbac-playbook groups/releng-compose.yml
 ....
 
-=== Lift RelEng freeze
+== Lift RelEng freeze
 
 Lift the RelEng Freeze so that the updates will be pushed to stable.
 This is done by editing
@@ -53,7 +53,7 @@ variable] in infra ansible repo and then run the bodhi playbook.
 $ sudo rbac-playbook groups/bodhi-backend.yml
 ....
 
-=== Stage Final Release for Mirrors
+== Stage Final Release for Mirrors
 
 . Gather the needed info for running the staging script: Release
 Version: the numerical version number of the release `{branched}` ComposeID: The
@@ -70,13 +70,13 @@ $ scripts/stage-release.sh {branched} Fedora-{branched}-20160614.0 {branched}_RC
 . Sync the release to the Red Hat internal archive following internally
 documented
 
-=== Check and set EOL on previous releases to reflect reality
+== Check and set EOL on previous releases to reflect reality
 
 . check PDC for active releases and respective EOL date
 . if needed run the adjust-eol-all.py script from releng repository to
 correct any mistakes
 
-=== Verification
+== Verification
 
 Verification is somewhat difficult as one cannot look at the content via
 the web server due to permissions. Typically we ask somebody from the
diff --git a/modules/release_guide/pages/mass_rebuild.adoc b/modules/release_guide/pages/mass_rebuild.adoc
index c81043c..922bddd 100644
--- a/modules/release_guide/pages/mass_rebuild.adoc
+++ b/modules/release_guide/pages/mass_rebuild.adoc
@@ -1,18 +1,18 @@
 include::_partials/attributes.adoc[]
 
-== Mass rebuild information.
+= Mass rebuild information.
 
-=== Description
+== Description
 
 Periodically we do mass rebuilds of rawhide during the development cycle. This SOP will outline the steps necessary to do this.
 
-=== Assumptions
+== Assumptions
 
 This assumes that the mass rebuild has already been approved and scheduled via release engineering and FESCo. Coordinate with infrastructure as well for any needed koji updates.
 
 This also assumes that the mass rebuild does not need to be done in dependency order, and that the mass rebuild does not involve a ABI change.
 
-=== Considerations
+== Considerations
 
 The most important thing to keep in mind while doing a mass rebuild is to communicate clearly what actions are being performed and the status of the rebuild.
 
@@ -20,20 +20,20 @@ Check in on scripts frequently to avoid a long stalled command from adding signi
 
 Check with secondary arches, whether they up-to-date enough with primary, create rebuild tag and target when they are. It will then take care of rebuilds of the arch specific packages in appropriate kojis.
 
-=== Actions
+== Actions
 
-==== Preparatory Steps
+=== Preparatory Steps
 
 The following steps may be completed in the weeks leading up to the scheduled mass rebuild.
 
-=== Mass Rebuild
+== Mass Rebuild
 
-==== Description
+=== Description
 
 Periodically we do mass rebuilds of rawhide during the development
 cycle. This SOP will outline the steps necessary to do this.
 
-==== Assumptions
+=== Assumptions
 
 This assumes that the mass rebuild has already been approved and
 scheduled via release engineering and FESCo. Coordinate with
@@ -43,7 +43,7 @@ This also assumes that the mass rebuild does not need to be done in
 dependency order, and that the mass rebuild does not involve a ABI
 change.
 
-==== Considerations
+=== Considerations
 
 * The most important thing to keep in mind while doing a mass rebuild is
 to communicate clearly what actions are being performed and the status
@@ -54,9 +54,9 @@ adding significant delays in completing the rebuild.
 primary, create rebuild tag and target when they are. It will then take
 care of rebuilds of the arch specific packages in appropriate kojis.
 
-==== Actions
+== Actions
 
-===== Preparatory Steps
+=== Preparatory Steps
 
 The following steps may be completed in the weeks leading up to the
 scheduled mass rebuild.
@@ -174,7 +174,7 @@ the mass rebuild is for have landed in the build system (and a newRepo
 task completed with those features)
 * the comment which is inserted into spec changelogs
 
-===== Starting the Mass Rebuild
+=== Starting the Mass Rebuild
 
 The `mass-rebuild.py` script takes care of:
 
@@ -211,7 +211,7 @@ $ ./mass-rebuild.py 2>&1 | tee ~/massbuild.out
 ....
 ____
 
-===== Monitoring Mass Rebuilds
+=== Monitoring Mass Rebuilds
 
 The community has a very high interest in the status of rebuilds and
 many maintainers will want to know if their build failed right away. The
@@ -260,7 +260,7 @@ Set up the Site for Packages that Need Rebuilt::
 $ while true; do ./need-rebuild.py > f{rawhide}-need-rebuild.html && cp f{rawhide}-need-rebuild.html /mnt/koji/mass-rebuild/f{rawhide}-need-rebuild.html; sleep 600; done
 ....
 
-===== Post Mass Rebuild Tasks
+=== Post Mass Rebuild Tasks
 
 Once the mass rebuild script completes, and all the pending builds have
 finished, the builds will need to be tagged. The `mass-tag.py` script
diff --git a/modules/release_guide/pages/release_eol.adoc b/modules/release_guide/pages/release_eol.adoc
index 4b1aa6c..cce2070 100644
--- a/modules/release_guide/pages/release_eol.adoc
+++ b/modules/release_guide/pages/release_eol.adoc
@@ -1,8 +1,8 @@
 include::_partials/attributes.adoc[]
 
-== End Of Life
+= End Of Life
 
-=== Description
+== Description
 
 Each release of Fedora is maintained as laid out in the
 https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle#Maintenance_Schedule[maintenance
@@ -11,10 +11,9 @@ enters `end of life` status. This procedure describes the tasks
 necessary to move a release to that status. To get the correct EOL date visit 
 https://fedorapeople.org/groups/schedule/f-{branched}/f-{branched}-key-tasks.html[release schedule] for the last release.
 
-=== Actions
+== Actions
 
-
-==== Reminder announcement
+=== Reminder announcement
 
 Send an email to devel@, devel-announce@, test-announce@, announce@
 lists as remainder about the release EOL. Use https://pagure.io/releng/blob/main/f/mail-templates/07-end-of-life.txt[template] from release engineering repo
@@ -24,7 +23,7 @@ lists as remainder about the release EOL. Use https://pagure.io/releng/blob/main
 Please ensure that the reminder email is scheduled to be sent one week before the end of life.
 ====
 
-==== Koji tasks
+=== Koji tasks
 
 * Disable builds by removing targets
 
@@ -49,7 +48,7 @@ and the script on compose-branched01.iad2.fedoraproject.org
 ./scripts/koji_cleanup_signed.py
 ....
 
-==== PDC tasks
+=== PDC tasks
 
 * Set PDC *active* value for the release to *False*
 
@@ -67,7 +66,7 @@ https://pagure.io/releng[releng] repo
 python scripts/pdc/adjust-eol-all.py <token> f{old_release} 2020-11-24
 ....
 
-==== Bodhi tasks
+=== Bodhi tasks
 
 * Run the following bodhi commands to set the releases state to
 *archived*
@@ -80,7 +79,7 @@ $ bodhi releases edit --name "F{old_release}C" --state archived
 $ bodhi releases edit --name "F{old_release}F" --state archived
 ....
 
-==== Fedora Infra Ansible Changes
+=== Fedora Infra Ansible Changes
 
 * We need to make changes to bodhi, koji, mbs, releng, autosign roles in
 ansible repo.
@@ -103,7 +102,7 @@ Another way to run the playbook is using rbac-playbook, in case one don't have s
 Syntax: sudo rbac-playbook mbs.yml
 ====
 
-==== MBS Platform Retirement
+=== MBS Platform Retirement
 
 * To retire the platform in mbs, run the following command on
 mbs-backend01.iad2.fedoraproject.org
@@ -113,18 +112,18 @@ mbs-backend01.iad2.fedoraproject.org
 $ sudo mbs-manager retire platform:f{old_release}
 ....
 
-==== Final announcement
+=== Final announcement
 
 * Send the final announcement to devel@, devel-announce@,
 test-announce@, announce@ lists
 
 Use https://pagure.io/releng/blob/main/f/mail-templates/07-end-of-life.txt[template] from release engineering repo
 
-===== Update FedoraPreviousPrevious.yaml in ansible repository
+==== Update FedoraPreviousPrevious.yaml in ansible repository
 
 * set the variable to False
 
-===== Move the EOL release to archive
+==== Move the EOL release to archive
 
 . Log into to bodhi-backend01 and become root
 +
diff --git a/modules/release_guide/pages/release_process.adoc b/modules/release_guide/pages/release_process.adoc
index 1dd5bb8..36a2767 100644
--- a/modules/release_guide/pages/release_process.adoc
+++ b/modules/release_guide/pages/release_process.adoc
@@ -1,39 +1,39 @@
 include::_partials/attributes.adoc[]
-= Release process.
+= Release process
 
-== Rawhide starts Fedora Linux {branched} development
-== Mass Rebuild: RPMs first, then modules
-== Branch Fedora Linux {branched} from Rawhide
-== Rawhide starts Fedora Linux {rawhide} development
-== Update Greenwave policy product_versions to add branched release
-== Post-branch Freeze (end date approximate)
-== Bodhi updates-testing activation point
-== Beta Freeze (starts at 1400 UTC)
-== Beta Release Public Availability
-== Final Freeze (starts at 1400 UTC)
-== Final Release Public Availability (GA)
-== Fedora Linux {old_release} EOL auto closure
-== Beta release Go/No-Go Meeting
-== Final release Go/No-Go Meeting
-== Update Greenwave policy product_versions to remove EOL release
-== Notifications for retirement of packages with security issues
-== Retire packages with security issues
-== fedora-repos update with the new keys is available in updates-testing
-== Begin reminders for packages that haven't rebuilt in last 2 releases
-== Re-sign F{branched} content with F{rawhide} key
-== Retire Orphaned and Long-Time FTBFS Rawhide Packages
-== Retire FTI packages in NEW state
-== Stage Beta on master minor
-== Bit-flip Beta to mirrors
-== Notify Mirrors of Beta Release
-== Set current release to active in Package database
-== Retire all packages with broken deps
-== Retire FTI packages in NEW state
-== Enable Updates in Bodhi for the current release
-== Stage Final on master minor
-== Bit-flip Final to mirrors
-== Update PDC with F{old_release} EOL date
-== REMINDER: EOL release final update push in 1 week
-== REMINDER: EOL release final update push in 1 day
-== Notify Mirrors of Final Release
-== Remove Beta images
+* Rawhide starts Fedora Linux {branched} development
+* Mass Rebuild: RPMs first, then modules
+* Branch Fedora Linux {branched} from Rawhide
+* Rawhide starts Fedora Linux {rawhide} development
+* Update Greenwave policy product_versions to add branched release
+* Post-branch Freeze (end date approximate)
+* Bodhi updates-testing activation point
+* Beta Freeze (starts at 1400 UTC)
+* Beta Release Public Availability
+* Final Freeze (starts at 1400 UTC)
+* Final Release Public Availability (GA)
+* Fedora Linux {old_release} EOL auto closure
+* Beta release Go/No-Go Meeting
+* Final release Go/No-Go Meeting
+* Update Greenwave policy product_versions to remove EOL release
+* Notifications for retirement of packages with security issues
+* Retire packages with security issues
+* fedora-repos update with the new keys is available in updates-testing
+* Begin reminders for packages that haven't rebuilt in last 2 releases
+* Re-sign F{branched} content with F{rawhide} key
+* Retire Orphaned and Long-Time FTBFS Rawhide Packages
+* Retire FTI packages in NEW state
+* Stage Beta on master minor
+* Bit-flip Beta to mirrors
+* Notify Mirrors of Beta Release
+* Set current release to active in Package database
+* Retire all packages with broken deps
+* Retire FTI packages in NEW state
+* Enable Updates in Bodhi for the current release
+* Stage Final on master minor
+* Bit-flip Final to mirrors
+* Update PDC with F{old_release} EOL date
+* REMINDER: EOL release final update push in 1 week
+* REMINDER: EOL release final update push in 1 day
+* Notify Mirrors of Final Release
+* Remove Beta images
diff --git a/modules/release_guide/pages/sop_bodhi_activation.adoc b/modules/release_guide/pages/sop_bodhi_activation.adoc
index 7f78765..fe73eb1 100644
--- a/modules/release_guide/pages/sop_bodhi_activation.adoc
+++ b/modules/release_guide/pages/sop_bodhi_activation.adoc
@@ -1,16 +1,16 @@
 include::_partials/attributes.adoc[]
 
-== Bodhi Activation Point
+= Bodhi Activation Point
 
-=== Description
+== Description
 
 Bodhi must be activated after two weeks of
 https://docs.pagure.org/releng/sop_mass_branching.html[Mass Branching]
 at 14:00 UTC.
 
-=== Action
+== Action
 
-==== Making koji changes
+=== Making koji changes
 
 Make the following koji tag changes
 
@@ -27,7 +27,7 @@ $ koji add-tag-inheritance f{branched}-override f{branched}-updates
 $ koji edit-tag --perm=admin f{branched}
 ....
 
-==== Update bodhi rpm release
+=== Update bodhi rpm release
 
 Set the bodhi rpm to release to not to automatically create the update
 and also bodhi knows to compose the updates
@@ -37,7 +37,7 @@ and also bodhi knows to compose the updates
 $ bodhi releases edit --name "F{branched}" --stable-tag f{branched}-updates --testing-repository updates-testing --package-manager dnf --no-create-automatic-updates --composed-by-bodhi --state frozen
 ....
 
-==== Add the modular release
+=== Add the modular release
 
 Run the following command on your own workstation to add the modular
 release
@@ -47,7 +47,7 @@ release
 $ bodhi releases create --name F{branched}M --long-name "Fedora {branched} Modular" --id-prefix FEDORA-MODULAR --version {branched} --branch f{branched}m --dist-tag f{branched}-modular --stable-tag f{branched}-modular-updates --testing-tag f{branched}-modular-updates-testing --candidate-tag f{branched}-modular-updates-candidate --pending-stable-tag f{branched}-modular-updates-pending --pending-testing-tag f{branched}-modular-updates-testing-pending --pending-signing-tag f{branched}-modular-signing-pending --override-tag f{branched}-modular-override --state pending --user <fas username>
 ....
 
-Please update fas account username in above command.        
+Please update fas account username in above command.
 
 [WARNING]
 ====
@@ -69,7 +69,8 @@ ansible
 
 === Update all relevant projects in ansible
 As in https://pagure.io/fedora-infra/ansible/pull-request/1327[this Ansible Pull request] create changes for the {branched} release
-==== Run the playbooks
+
+=== Run the playbooks
 
 ....
 $ rbac-playbook openshift-apps/greenwave.yml
@@ -85,7 +86,7 @@ can monitor
 https://greenwave-web-greenwave.app.os.fedoraproject.org/api/v1.0/policies
 to wait for the new policy to appear (it should take a few minutes).
 
-==== Restart bodhi services
+=== Restart bodhi services
 
 Restart bodhi services to understand the bodhi new release on
 bodhi-backend01 (Look at warning in
@@ -98,7 +99,7 @@ $ sudo systemctl restart fm-consumer@config
 $ sudo systemctl restart koji-sync-listener
 ....
 
-==== Send Announcement
+=== Send Announcement
 
 Email *devel-announce* and *test-announce* lists about Bodhi Activation.
 Please find the body of the email in templates dir in https://pagure.io/releng/blob/main/f/mail-templates/04-beta-freeze.txt[releng repository]
@@ -124,7 +125,7 @@ $ bodhi releases info {current}
 
 Check for other variants like modular, container and flatpaks
 
-=== Consider Before Running
+== Consider Before Running
 
 No considerations at this time. The docs git repository is simply a
 static html hosting space and we can just re-render the docs and push to
diff --git a/modules/release_guide/pages/sop_end_of_life.adoc b/modules/release_guide/pages/sop_end_of_life.adoc
index cc504a1..345edfd 100644
--- a/modules/release_guide/pages/sop_end_of_life.adoc
+++ b/modules/release_guide/pages/sop_end_of_life.adoc
@@ -1,8 +1,8 @@
 include::_partials/attributes.adoc[]
 
-== End Of Life
+= End Of Life
 
-=== Description
+== Description
 
 Each release of Fedora is maintained as laid out in the
 https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle#Maintenance_Schedule[maintenance
@@ -10,9 +10,9 @@ schedule]. At the conclusion of the maintenance period, a Fedora release
 enters `end of life` status. This procedure describes the tasks
 necessary to move a release to that status.
 
-=== Actions
+== Actions
 
-==== Set date
+=== Set date
 
 * {blank}
 +
@@ -24,12 +24,12 @@ Releng responsibilities:::
   resource contention
   ** Announce the closure of the release to the package maintainers.
 
-==== Reminder announcement
+=== Reminder announcement
 
 Send an email to devel@, devel-announce@, test-announce@, announce@
 lists as remainder about the release EOL.
 
-===== Announcement Content
+==== Announcement Content
 
 ....
 Hello all,
@@ -52,7 +52,7 @@ Mohan Boddu.
 [1]https://fedoraproject.org/wiki/Upgrading?rd=DistributionUpgrades
 ....
 
-==== Koji tasks
+=== Koji tasks
 
 * Disable builds by removing targets
 
@@ -76,7 +76,7 @@ and the script on compose-branched01.iad2.fedoraproject.org
 ./scripts/koji_cleanup_signed.py
 ....
 
-==== PDC tasks
+=== PDC tasks
 
 * Set PDC *active* value for the release to *False*
 
@@ -92,7 +92,7 @@ https://pagure.io/releng[releng] repo
 python scripts/pdc/adjust-eol-all.py <token> f31 2020-11-24
 ....
 
-==== Bodhi tasks
+=== Bodhi tasks
 
 * Run the following bodhi commands to set the releases state to
 *archived*
@@ -118,7 +118,7 @@ $ sudo systemctl restart fm-consumer@config.service
 $ sudo systemctl restart bodhi-celery.service
 ....
 
-==== Fedora Infra Ansible Changes
+=== Fedora Infra Ansible Changes
 
 * We need to make changes to bodhi, koji, mbs, releng, autosign roles in
 ansible repo.
@@ -415,7 +415,7 @@ $ sudo ansible-playbook /srv/web/infra/ansible/playbooks/manual/autosign.yml
 $ sudo ansible-playbook /srv/web/infra/ansible/playbooks/openshift-apps/bodhi.yml
 ....
 
-==== MBS Platform Retirement
+=== MBS Platform Retirement
 
 * To retire the platform in mbs, run the following command on
 mbs-backend01.iad2.fedoraproject.org
@@ -424,12 +424,12 @@ mbs-backend01.iad2.fedoraproject.org
 $ sudo mbs-manager retire platform:f31
 ....
 
-==== Final announcement
+=== Final announcement
 
 * Send the final announcement to devel@, devel-announce@,
 test-announce@, announce@ lists
 
-===== Announcement content
+==== Announcement content
 
 ....
 Hello all,
@@ -450,16 +450,16 @@ Mohan Boddu.
 [1] https://docs.fedoraproject.org/en-US/quick-docs/dnf-system-upgrade/
 ....
 
-===== Update eol wiki page
+=== Update eol wiki page
 
 https://fedoraproject.org/wiki/End_of_life update with release and
 number of days.
 
-===== Update FedoraPreviousPrevious.yaml in ansible repository
+=== Update FedoraPreviousPrevious.yaml in ansible repository
 
 set the variable to False
 
-===== Move the EOL release to archive
+=== Move the EOL release to archive
 
 . log into to bodhi-backend01 and become root
 +
@@ -535,7 +535,7 @@ $ ln ../20/README .
 ....
 ____
 
-=== Consider Before Running
+== Consider Before Running
 
 * Resource contention in infrastructure, such as outages
 * Extenuating circumstances for specific planned updates, if any
diff --git a/modules/release_guide/pages/sop_file_ftbfs.adoc b/modules/release_guide/pages/sop_file_ftbfs.adoc
index 9b65928..08a9bb8 100644
--- a/modules/release_guide/pages/sop_file_ftbfs.adoc
+++ b/modules/release_guide/pages/sop_file_ftbfs.adoc
@@ -1,6 +1,6 @@
-== File FTBFS
+= File FTBFS
 
-=== Description
+== Description
 
 [NOTE]
 ====
@@ -14,7 +14,7 @@ This should be run after the
 https://docs.pagure.org/releng/sop_mass_rebuild_packages.html#post-mass-rebuild-tasks[mass
 rebuild builds are merged into main tag].
 
-=== Action
+== Action
 
 The FTBFS bugs are filed in bugzilla.
 
diff --git a/modules/release_guide/pages/sop_mass_branching.adoc b/modules/release_guide/pages/sop_mass_branching.adoc
index f5bdb21..f8c5425 100644
--- a/modules/release_guide/pages/sop_mass_branching.adoc
+++ b/modules/release_guide/pages/sop_mass_branching.adoc
@@ -2,6 +2,8 @@ include::_partials/attributes.adoc[]
 
 = Mass Branching
 
+== Description
+
 At each alpha freeze we branch the pending release away from `devel/`
 which allows rawhide (currently F{rawhide}) to move on while the pending release goes into
 bugfix and polish mode.