From 56ebedb9879b4c64c3ca7c99b1f5bbcbad579162 Mon Sep 17 00:00:00 2001
From: Michal Konecny <mkonecny@redhat.com>
Date: Sep 05 2023 14:08:43 +0000
Subject: Fix build errors and warnings


This commit fixes all current errors and warnings shown by antora during
documentation build.

Signed-off-by: Michal Konecny <mkonecny@redhat.com>

---

diff --git a/modules/ROOT/pages/map_critical_services.adoc b/modules/ROOT/pages/map_critical_services.adoc
index 8351dd5..673dc6f 100644
--- a/modules/ROOT/pages/map_critical_services.adoc
+++ b/modules/ROOT/pages/map_critical_services.adoc
@@ -138,12 +138,12 @@ wouldn't be possible. This would render test pipelines unusable.
 |https://github.com/containerbuildsystem/osbs-client[OSBS]
 |OSBS (OpenShift Build System) is used to build container images for Fedora.
 |Without OSBS Fedora containers couldn't be built.
-|`osbs-control01.iad2.fedoraproject.org` `osbs-node0{1-2}.iad2.fedoraproject.org` `osbs-master01.iad2.fedoraproject.org` `osbs-aarch64-master01.iad2.fedoraproject.org` `osbs-aarch64-node0{1-2}.iad2.fedoraproject.org`
+|`osbs-control01.iad2.fedoraproject.org` `osbs-node0\{1-2}.iad2.fedoraproject.org` `osbs-master01.iad2.fedoraproject.org` `osbs-aarch64-master01.iad2.fedoraproject.org` `osbs-aarch64-node0\{1-2}.iad2.fedoraproject.org`
 
 |https://pagure.io/koji/[Koji builders]
 |Koji builders are machines of various architectures used by Koji to build the artifacts.
 |Without koji builders no artifact could be built.
-|`buildvm-{x86,a64,ppc64le,a32}-{01-XX}.iad2.fedoraproject.org` `buildvm-s390x-{01-XX}.s390.fedoraproject.org`
+|`buildvm-{x86,a64,ppc64le,a32}-\{01-XX}.iad2.fedoraproject.org` `buildvm-s390x-\{01-XX}.s390.fedoraproject.org`
 
 |https://pagure.io/greenwave[greenwave]
 |Greenwave is a component that decides whether the package can pass gating or not.
@@ -153,7 +153,7 @@ wouldn't be possible. This would render test pipelines unusable.
 |https://pagure.io/koji/[Koji]
 |Koji is a build system handling artifact building.
 |Without Koji we wouldn't be able to build any artifact.
-|`koji0{1-2}.iad2.fedoraproject.org`
+|`koji0\{1-2}.iad2.fedoraproject.org`
 
 |https://github.com/fedora-infra/bodhi[Bodhi]
 |Bodhi is a system that manages package updates for Fedora distribution.
@@ -168,7 +168,7 @@ wouldn't be possible. This would render test pipelines unusable.
 |https://pagure.io/releng/tag2distrepo[tag2distrepo]
 |Koji plugin that automatically generates dist repositories on tag operations.
 |Without tag2distrepo packagers wouldn't be able to create repositories on specific tag.
-|`koji0{1-2}.iad2.fedoraproject.org`
+|`koji0\{1-2}.iad2.fedoraproject.org`
 
 |https://pagure.io/sigul[sigul]
 |Component that does signing of the artifacts. Called by robosignatory.
@@ -202,7 +202,7 @@ https://src.fedoraproject.org/[dist-git].
 |RabbitMQ is a message broker used by fedora messaging. It assures that the message
 is delivered from publisher to consumer.
 |Without it the messages will not be delivered and most of the infra will stop working.
-|`rabbitmq0{1-3}.iad2.fedoraproject.org`
+|`rabbitmq0\{1-3}.iad2.fedoraproject.org`
 
 |https://github.com/fedora-infra/fedora-messaging[fedora messaging]
 |Python library for working with fedora messaging system. It helps you create fedora
@@ -231,7 +231,7 @@ with fedora messages and affect whole Fedora infrastructure.
 |Mediawiki is used by Fedora as their choice of Wikipedia-like web server. It's powering
 https://fedoraproject.org/wiki[Fedora wiki pages].
 |Without wiki Fedora wiki pages wouldn't run.
-|`wiki0{1-2}.iad2.fedoraproject.org`
+|`wiki0\{1-2}.iad2.fedoraproject.org`
 
 |https://github.com/fedora-infra/fmn[FMN]
 |FMN (FedMSG Notifications) is an application listening for messages in Fedora infra and based on the
diff --git a/modules/ocp4/pages/sop_fas2discourse_operator.adoc b/modules/ocp4/pages/sop_fas2discourse_operator.adoc
index 371bde3..f83063b 100644
--- a/modules/ocp4/pages/sop_fas2discourse_operator.adoc
+++ b/modules/ocp4/pages/sop_fas2discourse_operator.adoc
@@ -6,7 +6,7 @@ The following SOPs are related to the administration of the fas2discourse operat
 - https://quay.io/repository/fedora/fas2discourse-operator[Image]
 - https://pagure.io/fedora-infrastructure/issue/10952[Initial ticket]
 - xref:sop_fas2discourse_operator_installation.adoc[Install the fas2discourse operator]
-- xref:sop_fas2idscourse_operator_testing.adoc[Testing the fas2discourse operator]
+- xref:sop_fas2discourse_operator_testing.adoc[Testing the fas2discourse operator]
 - xref:sop_fas2discourse_operator_build.adoc[Building/releasing the fas2discourse operator]
 - xref:sop_fas2discourse_operator_interacting.adoc[Interacting with the the fas2discourse operator]
 - xref:sop_fas2discourse_operator_debugging.adoc[Debugging issues with the the fas2discourse operator]
diff --git a/modules/release_guide/pages/sop_mass_branching.adoc b/modules/release_guide/pages/sop_mass_branching.adoc
index 0221b4b..0600772 100644
--- a/modules/release_guide/pages/sop_mass_branching.adoc
+++ b/modules/release_guide/pages/sop_mass_branching.adoc
@@ -13,7 +13,7 @@ You will find below the list of steps to follow to branch a new Fedora release.
 == Mass resigning
 
 When we branch off of rawhide, the branched release packages are already signed by
-the F{release} key, but we need to resign everything in rawhide for the new F+1 key.
+the F\{release} key, but we need to resign everything in rawhide for the new F+1 key.
 ie, When we branch f39 off rawhide, all it's packages are already signed by the f39
 key, but we need to resign everything with the f40 key for rawhide.
 
@@ -254,7 +254,7 @@ Changes to `fedora-release.spec` in the *rawhide* branch:
 [source,subs="attributes"]
 ----
 Version:        {rawhide}
-Release:        0.1%{?eln:.eln%{eln}}
+Release:        0.1%{?eln:.eln%\{eln}}
 ----
 
 . Add a `%changelog` entry:
@@ -291,7 +291,7 @@ Version:        {branched}
 +
 [source,subs="attributes"]
 ----
-Release:        0.4%{?eln:.eln%{eln}}
+Release:        0.4%{?eln:.eln%\{eln}}
 ----
 
 . Add a `%changelog` entry:
@@ -341,7 +341,7 @@ fedora-{rawhide+1}-primary: x86_64 armhfp aarch64 ppc64le s390x
 [source,subs="attributes"]
 ----
 Version:        {rawhide}
-Release:        0.1%{?eln:.eln%{eln}}
+Release:        0.1%{?eln:.eln%\{eln}}
 ----
 
 . Add a `%changelog` entry:
@@ -385,7 +385,7 @@ Source57:       RPM-GPG-KEY-fedora-{rawhide_next}-primary
 +
 [source,subs="attributes"]
 ----
-Release:        0.3%{?eln:.eln%{eln}} +
+Release:        0.3%{?eln:.eln%\{eln}} +
 ----
 . Add a `%changelog` entry:
 +
@@ -426,7 +426,7 @@ Source57:       RPM-GPG-KEY-fedora-{rawhide_next}-primary
 +
 [source,subs="attributes"]
 ----
-Release:        0.3%{?eln:.eln%{eln}}
+Release:        0.3%{?eln:.eln%\{eln}}
 ----
 
 . Add a `%changelog` entry:
@@ -621,7 +621,7 @@ $ BASEIMAGE_URL="https://kojipkgs.fedoraproject.org//packages/Fedora-Docker-Base
 $ RAWHIDE="27"
 
 # Load the latest, find it's image name
-$ sudo docker load < <(curl -s "${BASEIMAGE_URL}")
+$ sudo docker load < <(curl -s "$\{BASEIMAGE_URL}")
 $ sudo docker images | grep base-rawhide
 fedora-docker-base-rawhide-20170310.n.0.x86_64      latest      ffd832a990ca        5 hours ago     201.8 MB
 
diff --git a/modules/sysadmin_guide/pages/fedora-releases.adoc b/modules/sysadmin_guide/pages/fedora-releases.adoc
index 1206bed..6e5e1f1 100644
--- a/modules/sysadmin_guide/pages/fedora-releases.adoc
+++ b/modules/sysadmin_guide/pages/fedora-releases.adoc
@@ -165,7 +165,7 @@ or not we release and they may pull the plug at any moment.
 
 Once given the ok to release, the Infrastructure team should publish the
 torrent and encourage people to seed. Complete the steps on the
-<<torrentrelease.adoc#>> after step 4.
+<<infra:release_guide:torrentrelease.adoc#>> after step 4.
 
 === Step 3 (Bit flip)
 
diff --git a/modules/sysadmin_guide/pages/sshaccess.adoc b/modules/sysadmin_guide/pages/sshaccess.adoc
index 9a0dd34..debfeb3 100644
--- a/modules/sysadmin_guide/pages/sshaccess.adoc
+++ b/modules/sysadmin_guide/pages/sshaccess.adoc
@@ -44,21 +44,21 @@ run: 'ssh-keygen -t ed25519'
 Make sure you enter a strong passphrase you can remember or have stored in a password manager.
 
 2. Setup your local client ssh config
-
++
 ....
 vi ~/.ssh/config
 ....
-
++
 (Or use any text editor you are comfortable with)
-
++
 [NOTE]
 ====
 This file, and any keys, need to be mode 600, or you will get a "Bad
 owner or permissions" error. The .ssh directory must be mode 700.
 ====
-
++
 then, add the following contents to that text file:
-
++
 ....
 Host bastion.fedoraproject.org
   HostName bastion.fedoraproject.org
@@ -70,7 +70,7 @@ Host *.iad2.fedoraproject.org *.qa.fedoraproject.org 10.3.160.* 10.3.161.* 10.3.
 Host batcave01
   HostName %h.iad2.fedoraproject.org
 ....
-
++
 Note that there are 2 bastion servers: bastion01.fedoraproject.org
 and bastion02.fedoraproject.org. The 'bastion.fedoraproject.org' name
 should match whichever one is primary at any time. If for some reason
@@ -79,11 +79,11 @@ change the above to specifically point to bastion01 or bastion02.
 Normally this should not be needed.
 
 3. Setup the fedora infrastructure ssh hostkey certificate authority:
-
-download https://admin.fedoraproject.org/ssh_known_hosts
++
+Download https://admin.fedoraproject.org/ssh_known_hosts
 and add it to (or create if it does not yet exist) a
 ~/.ssh/known_hosts file.
-
++
 This tells OpenSSH to trust any host keys that are signed with
 the fedora infrastructure ssh certificate authority. This allows
 you to know when you login to a machine that it's not been

