egret/team-docs
1
0
Fork 1
forked from docs/team-docs
Code Pull requests Wiki Activity

into-draft3

Browse source
This commit is contained in:
Eli Ridge 2026-06-02 16:26:02 +12:00
commit 4a65c4a82d
1 changed files with 3 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

25
modules/ROOT/pages/contributing-docs/index.adoc
View file

@ -1,31 +1,15 @@
= Contribute to Fedora Docs
= Contribute to Fedora Documentation
Fedora Documentation Team <https://discussion.fedoraproject.org/tag/docs-team>
:revdate: 2026-03-07
:page-aliases: contributing
//SUMMARY OF CHANGES
//added small motivational introduction
//suggest change of title, shorter
//abstract updated to reflect local workflow aims
//reordered tools to have local workflow as the first item
//removed tool section about direct edit to upstream??
// IDEAS FOR improvement/GENERAL COMMENTS
// Perhaps a visual contributor journey diagram
// definitions or links for terms like repo, Antora, merge, pull request.
//site.yml edit for xref preview:
//- url: https://gitlab.com/fedora/legal/fedora-legal-docs.git
// branches: main
[abstract]
____
Welcome to the Fedora Documentation Team.
If this is your first time contributing to an open source project, Fedora Documentation is an excellent place to start.
Whether you’re an experienced contributor or just getting started, your input is valuable and highly appreciated.
This page will explain the documentation tools we use and our review process.
____
@ -42,7 +26,7 @@ If you have some basic knowledge of Git and the AsciiDoc markup language, you ar
If not, take a few minutes to read xref:contributing-docs/asciidoc-markup.adoc[AsciiDoc for Fedora].
AsciiDoc and Git are easy to learn with time.
Okay, I feel ready to start contributing to Fedora Docs, what next?
Okay, you are ready to start contributing to Fedora Docs, what next?
== First steps
@ -132,10 +116,7 @@ Editing locally allows you to:
We encourage first time contributors to give the local workflow a go.
While there is a lot to learn, the power and flexibility of editing locally will be rewarding.
Refer to the xref:contributing-docs/tools-local-authoring-env.adoc[local workflow] guide for further information.
// fix local workflow xref above once the local workflow page is published
Refer to the xref:contributing-docs/tools-edit-local-clone.adoc[Local workflow] guide for further information.
=== Forge web interface