🏗️ docs: Scaffold Antora modules for SIG focus areas #3

Merged
jflory7 merged 1 commit from add/project-modules into main 2026-09-01 21:53:43 +00:00
11 changed files with 86 additions and 0 deletions
Showing only changes of commit 8ee2b0abf1 - Show all commits

🏗️ docs: Scaffold Antora modules for SIG focus areas

Create five new Antora modules reflecting the AI/ML SIG's mission areas:
`packaging` (RPM packaging), `resistor` (AI Developer Desktop), `users`
(user guides for AI tools on Fedora), `contrib` (Agent Skills Library
and workflows), and `infra` (build systems, COPR, CI, GPU hardware).

Each module has a placeholder index page describing planned content and
linking to the "Get Involved" page in the ROOT module, and the new docs
content request issue template. This gives project leads and
contributors clear ownership areas they can populate independently.

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
Justin Wheeler 2026-08-13 17:48:00 -04:00
Signed by: jflory7
GPG key ID: 7748B15FA8FA4C7E

View file

@ -18,3 +18,8 @@ start_page: ROOT:index.adoc
# module first. If you create a new module, add its `nav.adoc` file below.
nav:
- modules/ROOT/nav.adoc
- modules/contrib/nav.adoc
- modules/infra/nav.adoc
- modules/packaging/nav.adoc
- modules/resistor/nav.adoc
- modules/users/nav.adoc

1
modules/contrib/nav.adoc Normal file
View file

@ -0,0 +1 @@
* xref:index.adoc[Skills & Workflows]

View file

@ -0,0 +1,15 @@
= Skills & Workflows
This module will contain documentation for the Agent Skills Library and AI-assisted contributor workflows.
Planned content includes:
* What Agent Skills are and how they work.
* The link:https://forge.fedoraproject.org/ai-ml/skills-library[Fedora AI Skills Library] and how to contribute.
* Examples of AI-assisted workflows used by Fedora contributors.
* The link:https://agentskills.io/specification[Agent Skills specification].
If you would like to contribute to this section, please see the xref:ROOT:get-involved.adoc#agent-skills[Agent Skills Library] section of the _Get Involved_ page.
TIP: This page is a placeholder.
Open a link:https://forge.fedoraproject.org/ai-ml/tickets/issues/new?template=docs_content.yml[documentation content request] to propose specific pages for this module.

1
modules/infra/nav.adoc Normal file
View file

@ -0,0 +1 @@
* xref:index.adoc[Infrastructure]

View file

@ -0,0 +1,15 @@
= Infrastructure
This module will contain documentation for the AI/ML SIG's build and test infrastructure.
Planned content includes:
* COPR groups and build workflows.
* CI and automated testing for AI/ML packages.
* GPU hardware inventory and access guidelines.
* Fedora Forge organization and repository structure.
If you would like to contribute to this section, please see the xref:ROOT:get-involved.adoc[_Get Involved_] page.
TIP: This page is a placeholder.
Open a link:https://forge.fedoraproject.org/ai-ml/tickets/issues/new?template=docs_content.yml[documentation content request] to propose specific pages for this module.

View file

@ -0,0 +1 @@
* xref:index.adoc[Packaging]

View file

@ -0,0 +1,15 @@
= Packaging
This module will contain documentation for AI/ML RPM packaging in Fedora.
Planned content includes:
* Package status and availability tables (ROCm, PyTorch, HuggingFace, llama-cpp, Ollama, and more).
* Packaging guides and best practices for AI/ML software.
* Build system and COPR workflow documentation.
* Hardware compatibility notes for packagers.
If you would like to contribute to this section, please see the xref:ROOT:get-involved.adoc#rpm-packaging[RPM packaging] section of the _Get Involved_ page.
TIP: This page is a placeholder.
Open a link:https://forge.fedoraproject.org/ai-ml/tickets/issues/new?template=docs_content.yml[documentation content request] to propose specific pages for this module.

View file

@ -0,0 +1 @@
* xref:index.adoc[AI Developer Desktop]

View file

@ -0,0 +1,15 @@
= AI Developer Desktop
This module will contain documentation for the AI Developer Desktop (Project Resistor).
Planned content includes:
* What the AI Developer Desktop is and who it is for.
* How to download, install, and try the desktop.
* Hardware requirements and GPU compatibility.
* How to contribute to the desktop project.
If you would like to contribute to this section, please see the xref:ROOT:get-involved.adoc#ai-developer-desktop[AI Developer Desktop] section of the _Get Involved_ page.
TIP: This page is a placeholder.
Open a link:https://forge.fedoraproject.org/ai-ml/tickets/issues/new?template=docs_content.yml[documentation content request] to propose specific pages for this module.

1
modules/users/nav.adoc Normal file
View file

@ -0,0 +1 @@
* xref:index.adoc[User Guides]

View file

@ -0,0 +1,16 @@
= User Guides
This module will contain guides for using AI tools on Fedora Linux.
Planned content includes:
* Getting started with local AI inference (Ollama, llama-cpp, RamaLama).
* GPU setup and tuning for AMD, Intel, and Nvidia hardware.
* Running and configuring AI models on Fedora.
* Using AI coding agents (pi-coding-agent, OpenClaw, Claude Code).
* Text-to-speech, image generation, and other AI applications.
If you would like to contribute to this section, please see the xref:ROOT:get-involved.adoc#user-documentation[User documentation] section of the _Get Involved_ page.
TIP: This page is a placeholder.
Open a link:https://forge.fedoraproject.org/ai-ml/tickets/issues/new?template=docs_content.yml[documentation content request] to propose specific pages for this module.