Start adding modifications and prepping for existence

.github/workflows/gh.yml

@@ -0,0 +1,29 @@
+---
+name: mkdocs build
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [ 3.8 ]
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+          architecture: x64
+
+      - name: Install requirements
+        run: python3 -m pip install -r requirements.txt
+
+      - name: Deploy
+        run: python3 -m mkdocs gh-deploy --force
+...

README.md

@@ -0,0 +1,14 @@
+# SIG/Core Wiki
+[![mkdocs build](https://github.com/rocky-linux/sig-core-wiki/actions/workflows/gh.yml/badge.svg)](https://github.com/rocky-linux/sig-core-wiki/actions/workflows/gh.yml)
+
+This is the wiki repository for SIG/Core.
+
+https://sig-core.rocky.page
+
+## Building
+
+To test the appearance of this wiki, give it a try:
+
+```
+
+```

docs/.pages

@@ -2,6 +2,6 @@
 nav:
   - ... | index.md
   - ... | about.md
-  - Documentation | documentation
+  - Documentation: documentation
-  - SOP | sop
+  - SOP: sop
 ...

docs/CNAME

@@ -1 +1 @@
-core.sig.rocky.page
+sig-core.rocky.page

docs/assets/icon-white.svg

@@ -0,0 +1,3 @@
+<svg width="4096" height="4096" viewBox="0 0 192 192" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M186.658 127.658C190.119 117.746 192 107.093 192 96C192 42.9807 149.019 0 96 0C42.9807 0 0 42.9807 0 96C0 122.234 10.523 146.011 27.5783 163.338L124.958 65.9584L149 90L186.658 127.658ZM169.122 158.205L124.958 114.042L55.7978 183.202C68.0268 188.849 81.6455 192 96 192C125.288 192 151.514 178.884 169.122 158.205Z" fill="white"/>
+</svg>

docs/documentation/.pages

@@ -1,6 +1,6 @@
 ---
 nav:
   - ... | index.md
-  - Composing Releases | compose.md
+  - Composing Releases: compose.md
-  - Empanadas | empanadas.md
+  - Empanadas: empanadas.md
 ...

docs/documentation/compose.md

@@ -0,0 +1,7 @@
+---
+title: Composing Releases
+---
+
+This page goes over the process of composing a release.
+
+More to come.

docs/documentation/empanadas.md

@@ -0,0 +1,43 @@
+---
+title: Empanadas
+---
+
+This page goes over `empanadas`, which is part of the SIG/Core toolkit. Empanadas
+assists SIG/Core is composing repositories, creating ISO's, creating images, and
+various other activities in Rocky Linux. It is also used for general testing and
+debugging of repositories and its metadata.
+
+## Contact Information
+
+| | |
+| - | - |
+| **Owner** | SIG/Core (Release Engineering & Infrastructure) |
+| **Email Contact** | releng@rockylinux.org |
+| **Mattermost Contacts** | `@label` `@neil` |
+| **Mattermost Channels** | `~Development` |
+
+## General Information
+
+`empanadas` is a python project using poetry, containing various built-in modules
+with the goal to try to emulate the Fedora Project's pungi to an extent. While it
+is not perfect, it achieves the very basic goals of creating repositories, images
+and ISO's for consumption by the end user. It also has interactions with peridot,
+the build system used by Rocky Linux to build the distribution.
+
+For performing syncs, it relies on the use of podman to perform syncing in a
+parallel fashion. This was done because it is not possible to run multiple dnf
+transactions at once on a single system and looping one repository at a time is
+not sustainable.
+
+## Requirements
+
+* Poetry must be available on the system
+* Podman must be installed on the system
+* fpart must be installed on the system (available in EPEL)
+* Enough storage should be available if repositories are being synced
+
+## Using Empanadas
+
+### 
+
+{% include "resources_bottom.md" %}

docs/documentation/index.md

@@ -16,10 +16,10 @@ derivative or another project entirely.
 The tools in use for the distribution are in the table below.
 
 | Tool            | Maintainer       | Code Location                                                       |
-|-----------------|-------------------|---------------------------------------------------------------------|
+|-----------------|------------------|---------------------------------------------------------------------|
-| srpmproc        | SIG/Core at Rocky | [GitHub](https://github.com/rocky-linux/srpmproc)                   |
+| srpmproc        | SIG/Core at RESF | [GitHub](https://github.com/rocky-linux/srpmproc)                   |
-| empanadas       | SIG/Core at Rocky | [sig-core-toolkit](https://github.com/rocky-linux/sig-core-toolkit) |
+| empanadas       | SIG/Core at RESF | [sig-core-toolkit](https://github.com/rocky-linux/sig-core-toolkit) |
-| Peridot         | SIG/Core at Rocky |                                                                     |
+| Peridot         | SIG/Core at RESF | [GitHub](https://github.com/rocky-linux/peridot)                    |
 | MirrorManager 2 | Fedora Project   | [MirrorManager2](https://github.com/fedora-infra/mirrormanager2)    |
 
 For Rocky Linux to be build, we use `Peridot` as the build system and
@@ -36,12 +36,17 @@ Step by step, it looks like this:
 * Distribution is built and maintained in Peridot
 * Comps and pungi configuration is converted into the peridot format for the project
 * Repositories are created in yumrepofs based on the configuration provided
+* A repoclosure is ran against the repositories from empanadas to ensure there are no critical issues
 * In Parallel:
+
     * Repositories are synced as a "full run" in empanadas
     * Lorax is ran using empanadas in the peridot cluster
+
 * Lorax results are pulled down from an S3 bucket
 * DVD images are built for each architecture
 * Compose directory is synced to staging for verification
+* Staging is synced to production to allow mirror syncing
+* Bit flip on release day
 
 ## General Updates
 

docs/include/resources_bottom.md

@@ -51,3 +51,16 @@
     **Technology**: Mailman 3 + Hyper Kitty
 
     **Contact**: `~Infrastructure` in Mattermost and `#rockylinux-infra` in Libera IRC
+
+=== "Contacts"
+
+    | Name                            | Email                   | Mattermost Name   | IRC Name           |
+    |---------------------------------|-------------------------|-------------------|--------------------|
+    | Louis Abel                      | label@rockylinux.org    | @nazunalika       | Sokel/label/Sombra |
+    | Mustafa Gezen                   | mustafa@rockylinux.org  | @mustafa          | mstg               |
+    | Skip Grube                      | skip@rockylinux.org     | @skip77           |                    |
+    | Sherif Nagy                     | sherif@rockylinux.org   | @sherif           |                    |
+    | Pablo Greco                     | pgreco@rockylinux.org   | @pgreco           | pgreco             |
+    | Neil Hanlon                     | neil@resf.org           | @neil             | neil               |
+    | Taylor Goodwill                 | tg@resf.org             | @tgo              | tg                 |
+

docs/index.md

@@ -6,18 +6,20 @@ title: SIG/Core
 
 ## About
 
-Rocky Linux Center for Technical Excellence
+The Rocky Linux Core Special Interest Group (SIG/Core) dedicates themselves to the development, building, production, and release of Rocky Linux for the Enterprise Linux community and the many users around the world. This group is a mixture of core Rocky Linux developers and infrastructure and the members of this group are also members of other groups within the Rocky Linux community (such as SIG/AltArch) as well as the Enterprise Linux community as a whole.
 
 ## Mission Statement
 
+SIG/Core strives to ensure a stable distribution is built, tested, and provided to the community from the RESF as a compatible derivative of Red Hat Enterprise Linux.
+
 ## Contact
 
 | Role                                              | Name                            | Email                   | Mattermost Name   | IRC Name           |
-|------------------------------------:  |-------------------------------  |---------------------    |---      | --- |
+|---------------------------------------------------|---------------------------------|------------------------ |-------------------|--------------------|
 | Identity Management & Release Engineering Co-Lead | Louis Abel                      | label@rockylinux.org    | @nazunalika       | Sokel/label/Sombra |
 | Release Engineering Co-Lead                       | Mustafa Gezen                   | mustafa@rockylinux.org  | @mustafa          | mstg               |
 | Release Engineering and Development               | Skip Grube                      | skip@rockylinux.org     | @skip77           |                    |
 | Release Engineering and Development               | Sherif Nagy                     | sherif@rockylinux.org   | @sherif           |                    |
-| Release Engineering and Development   | Pablo Greco | N/A | @pgreco | pgreco |
+| Release Engineering and Development               | Pablo Greco                     | pgreco@rockylinux.org   | @pgreco           | pgreco             |
 | Infrastructure                                    | Neil Hanlon                     | neil@resf.org           | @neil             | neil               |
 | Infrastructure                                    | Taylor Goodwill                 | tg@resf.org             | @tgo              | tg                 |

docs/sop/.pages

@@ -1,4 +1,5 @@
----                                                                                                                                                                                                                  nav:
+---
+nav:
   - ... | index.md
-  - Release Procedures | sop_release.md
+  - Release Procedures: sop_release.md
 ...

mkdocs.yml

@@ -1,7 +1,7 @@
 ---
 # Wiki information
 site_name: SIG/Core Wiki
-site_url: https://core.sig.rocky.page
+site_url: https://sig-core.rocky.page
 site_description: >-
   The wiki for Rocky Linux Core SIG.
 
@@ -11,7 +11,19 @@ repo_name: sig_core/wiki
 edit_uri: edit/main/docs/
 
 theme:
-  name: cinder
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/weather-night
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/weather-night
+        name: Switch to dark mode
+  logo: assets/icon-white.svg
   highlightjs: true
   hljs_languages:
     - bash
@@ -19,12 +31,12 @@ theme:
     - yaml
     - perl
   features:
-    - navigation.tabs
-    - navigation.tabs.sticky
-    - navigation.top
     - search.highlight
     - search.suggest
     - toc.integrate
+    #- navigation.tabs
+    #- navigation.tabs.sticky
+    #- navigation.top
 markdown_extensions:
   - abbr
   - admonition