Add comments, remove redundant pre-commit job

.github/workflows/build.yml

@@ -5,20 +5,8 @@ on:
   workflow_call:
 
 jobs:
-  build-precommit:
-    name: Run pre-commit hooks
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          submodules: true
-      - uses: actions/setup-python@v4
-        with:
-          python-version: "3.11"
-      - uses: pre-commit/[email protected]
   build-mkdocs:
     name: Build docs using MkDocs
-    needs: build-precommit
     runs-on: ubuntu-22.04
     steps:
       - name: Checkout with submodules

.github/workflows/main.yml

@@ -1,4 +1,4 @@
-name: Main
+name: main
 
 on:
   push:
@@ -7,7 +7,9 @@ on:
 
 jobs:
   build:
+    name: Build docs
     uses: ./.github/workflows/build.yml
   publish:
+    name: Publish docs
     uses: ./.github/workflows/publish.yml
     needs: build

.github/workflows/pre-commit.yml

@@ -1,4 +1,4 @@
-name: Pre-commit hooks
+name: Pre-commit Hooks
 
 on:
   workflow_dispatch:

.github/workflows/publish.yml

@@ -6,7 +6,6 @@ on:
 jobs:
   publish-githubpages:
     name: Publish docs to GitHub Pages
-    if: ${{ github.event.workflow_run.conclusion == 'success' }}
     runs-on: ubuntu-22.04
     steps:
       - name: Download Buildarr Docs from build artifacts

.github/workflows/pull_request.yml

@@ -5,7 +5,9 @@ on:
 
 jobs:
   pre-commit:
+    name: Run pre-commit hooks
     uses: ./.github/workflows/pre-commit.yml
   build:
+    name: Build docs
     uses: ./.github/workflows/build.yml
     needs: pre-commit