Add package building instructions for macos and windows

.github/workflows/build-macos-packages.yml

@@ -97,7 +97,7 @@ jobs:
           rm install-cert.p12
           security set-key-partition-list -S apple-tool:,apple: -k "${{ secrets.MAC_SIGN_DEV_PASSWORD }}" "${{ secrets.MAC_SIGN_DEV_KEYCHAIN }}" &> /dev/null
 
-      - name: Build MacOS Package Using Existing Onedir
+      - name: Build MacOS Package
         env:
           DEV_APP_CERT: "${{ secrets.MAC_SIGN_DEV_APP_CERT }}"
           DEV_INSTALL_CERT: "${{ secrets.MAC_SIGN_DEV_INSTALL_CERT }}"

.github/workflows/build-windows-packages.yml

@@ -97,7 +97,7 @@ jobs:
         run: |
           echo "${{ secrets.WIN_SIGN_CERT_FILE_B64 }}" | base64 --decode > /d/Certificate_pkcs12.p12
 
-      - name: Build Windows Packages Using Existing Onedir
+      - name: Build Windows Packages
         run: |
           tools pkg build windows ${{
             matrix.source == 'onedir' &&

doc/topics/packaging/index.rst

@@ -13,7 +13,7 @@ are built with the `relenv <https://github.com/saltstack/relative-environment-fo
 
 Docker Containers
 =================
-The Salt Project uses docker containers to build our packages. If you are building your own packages you can use
+The Salt Project uses docker containers to build our deb and rpm packages. If you are building your own packages you can use
 the same containers we build with in the Github piplines. These containers are documented `here <https://github.com/saltstack/salt-ci-containers/tree/main/custom/packaging>`_.
 
 
@@ -53,6 +53,13 @@ How to build onedir only
 
 How to build rpm packages
 =========================
+
+#. Ensure you are in the current Salt cloned git repo:
+
+    .. code-block:: bash
+
+       cd <path-to-salt-repo>
+
 #. Install the dependencies:
 
     .. code-block:: bash
@@ -72,12 +79,6 @@ How to build rpm packages
 
        pip install -r requirements/static/ci/py{python_version}/changelog.txt
 
-#. Ensure you are in the current Salt cloned git repo:
-
-    .. code-block:: bash
-
-       cd <path-to-salt-repo>
-
 #. (Optional) To build a specific Salt version, run tools and set Salt version:
 
     .. code-block:: bash
@@ -93,10 +94,15 @@ How to build rpm packages
        tools pkg build rpm --relenv-version <relenv-version> --python-version <python-version> --arch <arch>
 
 
-
 How to build deb packages
 =========================
 
+#. Ensure you are in the current Salt cloned git repo.:
+
+    .. code-block:: bash
+
+       cd <path-to-salt-repo>
+
 #. Install the dependencies:
 
     .. code-block:: bash
@@ -113,12 +119,6 @@ How to build deb packages
 
        pip install -r requirements/static/ci/py{python_version}/changelog.txt
 
-#. Ensure you are in the current Salt cloned git repo.:
-
-    .. code-block:: bash
-
-       cd <path-to-salt-repo>
-
 #. (Optional) To build a specific Salt version, run tools and set Salt version:
 
     .. code-block:: bash
@@ -135,6 +135,56 @@ How to build deb packages
        tools pkg build deb --relenv-version <relenv-version> --python-version <python-version> --arch <arch>
 
 
+How to build MacOS packages
+===========================
+
+#. Ensure you are in the current Salt cloned git repo.:
+
+    .. code-block:: bash
+
+       cd <path-to-salt-repo>
+
+#. Install the dependencies:
+
+    .. code-block:: bash
+
+       pip install -r requirements/static/ci/py{python_version}/tools.txt
+
+#. Build the MacOS package:
+
+    Only the salt-version argument is required, the rest are optional.
+    Do note that you will not be able to sign the packages when building them.
+
+    .. code-block:: bash
+
+       tools pkg build macos --salt-version <salt-version>
+
+
+How to build Windows packages
+=============================
+
+#. Ensure you are in the current Salt cloned git repo.:
+
+    .. code-block:: bash
+
+       cd <path-to-salt-repo>
+
+#. Install the dependencies:
+
+    .. code-block:: bash
+
+       pip install -r requirements/static/ci/py{python_version}/tools.txt
+
+#. Build the MacOS package:
+
+    Only the arch and salt-version arguments are required, the rest are optional.
+    Do note that you will not be able to sign the packages when building them.
+
+    .. code-block:: bash
+
+       tools pkg build windows --salt-version <salt-version> --arch <arch>
+
+
 How to access python binary
 ===========================