ai-ml/docs
12
1
Fork 0
Code Issues Pull requests 2 Activity Actions

📝 docs: Add Get Involved page for new contributors #1

Open
jflory7 wants to merge 1 commit from add/get-involved into main
pull from: add/get-involved
merge into: ai-ml:main
Conversation 4 Commits 1 Files changed 2 +131
jflory7 commented 2026-08-13 19:21:19 +00:00
Owner
Copy link

Create a landing page that describes the four main contribution areas for the AI/ML SIG: RPM packaging, the Agent Skills Library, the AI Developer Desktop (Project Resistor), and user documentation. Each area explains what contributors would do and how to get started, with links to the relevant repos and resources.

The page is designed to both welcome packagers and non-packager contributors, since the SIG's big-tent approach includes skills development, desktop building, documentation, and community engagement alongside the core packaging work.

Closes: ai-ml/tickets#29

A screenshot of the dark-mode "Get Involved" documentation page from AI/ML SIG Fedora Docs. It lists various contribution areas like RPM packaging, Agent Skills Library, AI Developer Desktop, and User documentation, each with bulleted instructions on how to participate.

Create a landing page that describes the four main contribution areas for the AI/ML SIG: RPM packaging, the Agent Skills Library, the AI Developer Desktop (Project Resistor), and user documentation. Each area explains what contributors would do and how to get started, with links to the relevant repos and resources. The page is designed to both welcome packagers and non-packager contributors, since the SIG's big-tent approach includes skills development, desktop building, documentation, and community engagement alongside the core packaging work. Closes: https://forge.fedoraproject.org/ai-ml/tickets/issues/29 ![A screenshot of the dark-mode "Get Involved" documentation page from AI/ML SIG Fedora Docs. It lists various contribution areas like RPM packaging, Agent Skills Library, AI Developer Desktop, and User documentation, each with bulleted instructions on how to participate.](/attachments/989f8c88-4401-4e16-b9ce-964fa0e2e3ed "A screenshot of a dark-themed AI/ML SIG Fedora Docs webpage titled \"Get Involved,\" displaying various sections and bulleted lists on how to contribute to the project.")
image.png
1 MiB 
Create a landing page that describes the four main contribution areas
for the AI/ML SIG: RPM packaging, the Agent Skills Library, the AI
Developer Desktop (Project Resistor), and user documentation. Each area
explains what contributors would do and how to get started, with links
to the relevant repos and resources.

The page is designed to both welcome packagers and non-packager
contributors, since the SIG's big-tent approach includes skills
development, desktop building, documentation, and community engagement
alongside the core packaging work.

Closes: ai-ml/tickets#29

Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
jflory7 force-pushed add/get-involved from 3a1a49aed9 to 757b8fe6df 2026-09-01 22:20:51 +00:00 Compare
jflory7 reviewed 2026-09-04 15:55:51 +00:00
modules/ROOT/pages/get-involved.adoc
@ -0,0 +72,4 @@
[[ai-developer-desktop]]
== AI Developer Desktop
jflory7 commented 2026-09-04 15:55:51 +00:00
Author
Owner
Copy link

@gordonmessmer Could you review this section specifically?

@gordonmessmer Could you review this section specifically?
jflory7 reviewed 2026-09-04 15:57:15 +00:00
modules/ROOT/pages/get-involved.adoc
@ -0,0 +49,4 @@
[[agent-skills]]
== Agent Skills Library
jflory7 commented 2026-09-04 15:57:15 +00:00
Author
Owner
Copy link

@cverna @lbarczio I think either of you could be good reviewers for the Agent Skills onboarding docs. Could you spare some time to take a look please? Thanks! 🙏

@cverna @lbarczio I think either of you could be good reviewers for the Agent Skills onboarding docs. Could you spare some time to take a look please? Thanks! 🙏
jflory7 reviewed 2026-09-04 15:58:10 +00:00
modules/ROOT/pages/get-involved.adoc
@ -0,0 +18,4 @@
[[rpm-packaging]]
== RPM packaging
jflory7 commented 2026-09-04 15:58:10 +00:00
Author
Owner
Copy link

@tflink @trix @xanderlent @jsteffan Y'all feel like the best people to review this "Get Involved" docs section for RPM packaging work in the SIG. Does this section make sense to each of you? Any suggestions or changes? Let me know! 🙏

@tflink @trix @xanderlent @jsteffan Y'all feel like the best people to review this "Get Involved" docs section for RPM packaging work in the SIG. Does this section make sense to each of you? Any suggestions or changes? Let me know! 🙏
jflory7 reviewed 2026-09-04 16:29:32 +00:00
modules/ROOT/pages/get-involved.adoc
@ -0,0 +44,4 @@
[NOTE]
====
*Related SIGs*:
Packaging work often overlaps with the link:{url_wiki}/SIGs/PyTorch[PyTorch SIG], link:{url_wiki}/SIGs/HC[Heterogeneous Computing SIG], and link:{url_wiki}/SIGs/ROCm[ROCm Packaging SIG].
jflory7 commented 2026-09-04 16:29:32 +00:00
Author
Owner
Copy link

Maybe could say more about the various sub-SIGs focused on packaging, using the wiki as a base, but there is not a huge difference of what is written there versus written here. Open to feedback on making this better!

Maybe could say more about the various sub-SIGs focused on packaging, using the [wiki](https://fedoraproject.org/wiki/SIGs/AI-ML#Get_Involved) as a base, but there is not a _huge_ difference of what is written there versus written here. Open to feedback on making this better!
lbarczio reviewed 2026-09-07 11:59:39 +00:00
lbarczio left a comment
Copy link

few suggestions regarding the Agent skills library section, otherwise looks great!

few suggestions regarding the Agent skills library section, otherwise looks great!
modules/ROOT/pages/get-involved.adoc
@ -0,0 +51,4 @@
[[agent-skills]]
== Agent Skills Library
The link:https://forge.fedoraproject.org/ai-ml/skills-library[Agent Skills Library] is a collection of reusable AI skills for Fedora community workflows.
lbarczio commented 2026-09-07 11:54:28 +00:00
Member
Copy link

I would clarify the skills focus in the beginning, maybe something like:

Skills can support a wide range of activities, including meeting support, issue triage, documentation, contributor onboarding, and other useful community workflows. Ideas for new skills are welcome.
I would clarify the skills focus in the beginning, maybe something like: ``` Skills can support a wide range of activities, including meeting support, issue triage, documentation, contributor onboarding, and other useful community workflows. Ideas for new skills are welcome. ```
modules/ROOT/pages/get-involved.adoc
@ -0,0 +62,4 @@
* Write new skills that automate or assist with Fedora contributor workflows.
* Improve existing skills based on real-world usage and feedback.
* Review skill contributions from other community members.
* Help maintain reference data and templates that skills depend on.
lbarczio commented 2026-09-07 11:57:28 +00:00
Member
Copy link
- * Help maintain reference data and templates that skills depend on.
+ * Help maintain reference data and templates that skills depend on.
+ * Try existing skills on representative Fedora tasks and report bugs, gaps, or confusing instructions.
+ ```
```diff - * Help maintain reference data and templates that skills depend on. + * Help maintain reference data and templates that skills depend on. + * Try existing skills on representative Fedora tasks and report bugs, gaps, or confusing instructions. + ```
modules/ROOT/pages/get-involved.adoc
@ -0,0 +68,4 @@
* Read the link:https://forge.fedoraproject.org/ai-ml/skills-library/src/branch/main/CONTRIBUTING.md[CONTRIBUTING.md] in the skills-library repo.
* Browse the link:https://forge.fedoraproject.org/ai-ml/skills-library/src/branch/main/skills[existing skills] to understand the format.
* Open a ticket in the link:{team_issue_tracker}[issue tracker] with the `type/skills` label to propose a new skill idea.
lbarczio commented 2026-09-07 11:59:01 +00:00
Member
Copy link
- * Open a ticket in the link:{team_issue_tracker}[issue tracker] with the `type/skills` label to propose a new skill idea.
+ * Open a ticket in the link:{team_issue_tracker}[issue tracker] with the `type/skills` label to propose a new skill idea.
+ See the link:https://forge.fedoraproject.org/ai-ml/skills-library/src/branch/main/REVIEWING.md[reviewing guide] if you want to review contributions.
+ * Submit a pull request when your skill or improvement is ready.
```diff - * Open a ticket in the link:{team_issue_tracker}[issue tracker] with the `type/skills` label to propose a new skill idea. + * Open a ticket in the link:{team_issue_tracker}[issue tracker] with the `type/skills` label to propose a new skill idea. + See the link:https://forge.fedoraproject.org/ai-ml/skills-library/src/branch/main/REVIEWING.md[reviewing guide] if you want to review contributions. + * Submit a pull request when your skill or improvement is ready.
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin add/get-involved:add/get-involved
git switch add/get-involved

Merge

Merge the changes and update on Forgejo.
git switch main
git merge --no-ff add/get-involved
git switch add/get-involved
git rebase main
git switch main
git merge --ff-only add/get-involved
git switch add/get-involved
git rebase main
git switch main
git merge --no-ff add/get-involved
git switch main
git merge --squash add/get-involved
git switch main
git merge --ff-only add/get-involved
git switch main
git merge add/get-involved
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
ai-ml/Members
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ai-ml/docs!1
No description provided.