🏗️ docs: Scaffold Antora modules for SIG focus areas #3
11 changed files with 86 additions and 0 deletions
🏗️ 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>
commit
8ee2b0abf1
|
|
@ -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
1
modules/contrib/nav.adoc
Normal file
|
|
@ -0,0 +1 @@
|
|||
* xref:index.adoc[Skills & Workflows]
|
||||
15
modules/contrib/pages/index.adoc
Normal file
15
modules/contrib/pages/index.adoc
Normal 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
1
modules/infra/nav.adoc
Normal file
|
|
@ -0,0 +1 @@
|
|||
* xref:index.adoc[Infrastructure]
|
||||
15
modules/infra/pages/index.adoc
Normal file
15
modules/infra/pages/index.adoc
Normal 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.
|
||||
1
modules/packaging/nav.adoc
Normal file
1
modules/packaging/nav.adoc
Normal file
|
|
@ -0,0 +1 @@
|
|||
* xref:index.adoc[Packaging]
|
||||
15
modules/packaging/pages/index.adoc
Normal file
15
modules/packaging/pages/index.adoc
Normal 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.
|
||||
1
modules/resistor/nav.adoc
Normal file
1
modules/resistor/nav.adoc
Normal file
|
|
@ -0,0 +1 @@
|
|||
* xref:index.adoc[AI Developer Desktop]
|
||||
15
modules/resistor/pages/index.adoc
Normal file
15
modules/resistor/pages/index.adoc
Normal 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
1
modules/users/nav.adoc
Normal file
|
|
@ -0,0 +1 @@
|
|||
* xref:index.adoc[User Guides]
|
||||
16
modules/users/pages/index.adoc
Normal file
16
modules/users/pages/index.adoc
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue