refactor: move Antora site from manual/ into docs/

- Playbook, package.json, and content under docs/; integrate maintainer guide as AsciiDoc page
- Rename workflow to publish-docs.yml; ignore docs/build and docs/node_modules
- Remove standalone publishing-marketplace.md (content lives in the published site nav)

Made-with: Cursor

Author: AMDphreak

.github/workflows/publish-the-manual.yml .github/workflows/publish-docs.yml.github/workflows/publish-the-manual.yml renamed to .github/workflows/publish-docs.yml

@@ -1,11 +1,11 @@
-name: Publish the manual
+name: Publish docs site
 
 on:
   push:
     branches: [main]
     paths:
-      - 'manual/**'
-      - '.github/workflows/publish-the-manual.yml'
+      - 'docs/**'
+      - '.github/workflows/publish-docs.yml'
   workflow_dispatch:
   schedule:
     - cron: '0 6 * * *'
@@ -30,28 +30,28 @@ jobs:
       - uses: pnpm/action-setup@v4
         with:
           version: 10.33.0
-          package_json_file: manual/package.json
+          package_json_file: docs/package.json
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: pnpm
-          cache-dependency-path: manual/pnpm-lock.yaml
+          cache-dependency-path: docs/pnpm-lock.yaml
 
       - name: Install dependencies
-        working-directory: manual
+        working-directory: docs
         run: pnpm install --frozen-lockfile
 
-      - name: Build the manual site
-        working-directory: manual
+      - name: Build the docs site
+        working-directory: docs
         run: pnpm exec antora antora-playbook.yml
 
       - name: Ensure .nojekyll
-        run: touch manual/build/site/.nojekyll
+        run: touch docs/build/site/.nojekyll
 
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: manual/build/site
+          path: docs/build/site
 
   deploy:
     needs: build

.gitignore

@@ -1,2 +1,2 @@
-manual/build/
-manual/node_modules/
+docs/build/
+docs/node_modules/

README.adoc

@@ -5,6 +5,6 @@ The **full manual** (multi-page, Antora-generated) is published here:
 
 https://antora-supplemental.github.io/antora-build-action/
 
-AsciiDoc sources and the playbook live in the `manual/` directory of this repository.
+AsciiDoc sources and the Antora playbook live in the `docs/` directory of this repository.
 
 The https://github.com/marketplace[GitHub Marketplace] listing is generated from `README.md` only.

README.md

@@ -6,7 +6,7 @@
 
 **https://antora-supplemental.github.io/antora-build-action/**
 
-The manual covers prerequisites, every input/output, authentication for private `content.sources`, multi-repo examples, official vs peaceiris Pages patterns, security, and troubleshooting. Source lives under `manual/` in this repository.
+The manual covers prerequisites, every input/output, authentication for private `content.sources`, multi-repo examples, official vs peaceiris Pages patterns, security, and troubleshooting. Source lives under `docs/` in this repository (AsciiDoc playbook + `content/`).
 
 > GitHub Marketplace ingests **this `README.md` only** (Markdown). Keep this file short; put depth in the manual.
 

manual/antora-playbook.yml docs/antora-playbook.ymlmanual/antora-playbook.yml renamed to docs/antora-playbook.yml

@@ -5,10 +5,10 @@ site:
 
 content:
   sources:
-    # Playbook lives in manual/; component root is manual/content (repo root is parent).
+    # Playbook in docs/; Antora component is docs/content (repo root is parent for git).
     - url: ..
       branches: HEAD
-      start_path: manual/content
+      start_path: docs/content
 
 output:
   dir: ./build/site

manual/content/antora.yml docs/content/antora.ymlmanual/content/antora.yml renamed to docs/content/antora.yml

@@ -14,3 +14,5 @@
 * xref:security.adoc[Security]
 * xref:troubleshooting.adoc[Troubleshooting]
 * xref:contributing.adoc[Contributing & legal]
+* Maintainers
+** xref:publishing-marketplace.adoc[Publishing to Marketplace]

manual/content/modules/ROOT/nav.adoc docs/content/modules/ROOT/nav.adocmanual/content/modules/ROOT/nav.adoc renamed to docs/content/modules/ROOT/nav.adoc

@@ -8,4 +8,4 @@ GitHub Pages can be updated in more than one way:
 
 **Antora Site Builder** intentionally **does not** choose a deploy mechanism: it runs Antora and exposes `site-path` so you can plug in whichever pattern your org standardizes on.
 
-**GitHub Marketplace** does **not** forbid `.github/workflows/` in an action repository: CI, tests, and lint workflows for the action itself are common. What you do **not** get is a workflow that automatically appears in a consumer’s repo—users add their own workflows and `uses:` your action. This repository publishes the **HTML manual** to GitHub Pages via `.github/workflows/publish-the-manual.yml`. Maintainer notes: https://github.com/antora-supplemental/antora-build-action/blob/main/docs/publishing-marketplace.md[publishing-marketplace.md].
+**GitHub Marketplace** does **not** forbid `.github/workflows/` in an action repository: CI, tests, and lint workflows for the action itself are common. What you do **not** get is a workflow that automatically appears in a consumer’s repo—users add their own workflows and `uses:` your action. This repository publishes this documentation site to GitHub Pages via `.github/workflows/publish-docs.yml`. Maintainer checklist: xref:publishing-marketplace.adoc[Publishing to Marketplace].