From b5e0845aab33241ee716d935425d7b029c0dd8a0 Mon Sep 17 00:00:00 2001
From: Pawel Zmarzly <pzmarzly0@gmail.com>
Date: Jan 16 2026 16:37:25 +0000
Subject: Update onboarding instructions


---

diff --git a/docs/internal/building.md b/docs/internal/building.md
index 8cb15bd..c005b30 100644
--- a/docs/internal/building.md
+++ b/docs/internal/building.md
@@ -2,17 +2,7 @@ This page is for people who want to become Hyperscale SIG members. If you want t
 
 # Becoming SIG member
 
-Before you start, you will need a CentOS (or Fedora) account, and a Gitlab.com account.
-
-See [Governance doc](../policies/governance.md) for how to request your membership.
-
-After you are approved, you will need to click [this magic Gitlab link](https://gitlab.com/groups/centos/-/saml/sso) to link your Gitlab and CentOS accounts together. You only need to do it once. If everything went right, you will see yourself in [the member list](https://gitlab.com/groups/CentOS/Hyperscale/-/group_members).
-
-# Software prerequisites
-
-* For local test builds: `mock` and `mock-centos-sig-configs`
-* To interact with the lookaside: `centos-get-sources` and `centos-lookaside-upload-sig` from `centos-packager`
-* To interact with CBS: `cbs` from `centos-packager`
+See [Governance doc](../policies/governance.md) for how to request your membership. Then see [Onboarding doc](./onboarding.md) for the required one-time setup.
 
 # Working with git
 
@@ -107,6 +97,7 @@ Note that you won't be able to tag into a destination tag unless it's been regis
 To run a scratch build from git:
 ```
 $ cbs build --scratch hyperscale9s-packages-main-el9s "git+https://gitlab.com/CentOS/Hyperscale/rpms/systemd.git#$(git rev-parse HEAD)"
+$ cbs download-task $TASK_ID
 ```
 
 To run a real build, the package needs to be registered to a destination tags first:
diff --git a/docs/internal/onboarding.md b/docs/internal/onboarding.md
index 90e976d..21b1475 100644
--- a/docs/internal/onboarding.md
+++ b/docs/internal/onboarding.md
@@ -1,30 +1,35 @@
 # How to join
 
 * Read the [charter](../sig/charter.md) and think about what/why/how you'd like to work on within the SIG
+* The formal membership policy is detailed on the [governance](../policies/governance.md) page, but the tl;dr is that we welcome anybody that's interested in doing work within the scope of the SIG
 * Join [#centos-hyperscale:fedoraproject.org](https://matrix.to/#/#centos-hyperscale:fedoraproject.org)
 * File an issue requesting to join (alternatively: request to join during one of the monthly meetings)
-* The formal membership policy is detailed on the [governance](../policies/governance.md) page, but the tl;dr is that we welcome anybody that's interested in doing work within the scope of the SIG
 
 # Onboarding
 
 New member side:
 
 * Before joining the SIG:
-  * Get a Fedora account [here](https://accounts.fedoraproject.org/) if you don't have one already
-  * Login on [pagure.io](http://pagure.io/), [src.fedoraproject.org](https://src.fedoraproject.org) and
-    [git.centos.org](https://git.centos.org) to initialize your account.
+  * Get a Fedora account [here](https://accounts.fedoraproject.org/) if you don't have one already.
+  * Get a Gitlab.com account if you don't have one already.
+  * Login on [pagure.io](http://pagure.io/) and [src.fedoraproject.org](https://src.fedoraproject.org) to initialize your account.
+  * Put your GitLab and Matrix usernames in Fedora account settings at `https://accounts.fedoraproject.org/user/$YOURUSER/settings/profile/`
 * After joining the SIG:
-  * Install [mock-centos-sig-configs](https://src.fedoraproject.org/rpms/mock-centos-sig-configs)
+  * Link your GitLab and Fedora accounts together by clicking [this magic Gitlab link](https://gitlab.com/groups/centos/-/saml/sso). You only need to do it once. If everything went right, you will see yourself in [the member list](https://gitlab.com/groups/CentOS/Hyperscale/-/group_members).
+  * Install required packages: `mock`, `mock-centos-sig-configs`, `fedora-packager` and `centos-packager`.
+    * `mock` and `mock-centos-sig-configs` are useful for local test builds.
+    * `centos-get-sources` and `centos-lookaside-upload-sig` from `centos-packager` are used to interact with the lookaside.
+    * `cbs` from `centos-packager` is the CLI to interact with CBS (Community Build Service). It's CentOS version of `koji` from `fedora-packager`.
   * Set up the [packager tools](https://docs.fedoraproject.org/en-US/package-maintainers/Installing_Packager_Tools/)
-    * Set up your `~/.fedora.upn` to tell our tooling your FAS username if it differs from your Unix name
-    * Make sure to acquire a Fedora Kerberos ticket as well. More information and debugging tips can be found [here](https://fedoraproject.org/wiki/Infrastructure/Kerberos).
-  * Install [centos-packager](https://wiki.centos.org/Authentication#TLS_certificate)
-  * Run `centos-cert` to generate a new certificate
-    * It'll take an hour or so for the certificate to become active
-    * Make a calendar reminder to renew it in 6 months
+    * Set up your `~/.fedora.upn` to tell our tooling your FAS username if it differs from your Unix name.
+    * Acquire a Fedora Kerberos ticket with `fkinit -u $FAS_USERNAME`.
+      * More information and debugging tips can be found [here](https://fedoraproject.org/wiki/Infrastructure/Kerberos).
+  * Run `centos-cert -u $FAS_USERNAME` to generate a new certificate.
+    * You may need to wait an hour or so after being added to the right groups until a certificate can be generated.
+    * Make a calendar reminder to renew it every 6 months.
 
-SIG side:
+# SIG side checklist
 
 * Add the Fedora account to https://pagure.io/group/centos-sig-hyperscale
-* Add the CentOS account to https://accounts.centos.org/group/sig-hyperscale
-* Update the members list on https://sigs.centos.org/hyperscale/sig/membership/
+* Add the Fedora account to https://accounts.fedoraproject.org/group/sig-hyperscale
+* Update [the members list](../sig/membership.md)

