docs/tickets

Move the contribution sections (writing&design) to a new module of its own #55

New issue

Open

opened 2026-06-30 11:02:05 +00:00 by pboy · 0 comments

pboy commented

2026-06-30 11:02:05 +00:00

Owner

We want to move the complete Docs Contributors Guide, which is currently integrated in the Docs Team documentation, into a separate module on the same level as the root module.

The reason is, we want to be able to place the Docs Contributors Doc on the Docs landing page.

New structure:

modules -|-- root/
         |-- contributing/ (naming about 2 years ago before we moved it into team docs 
                 |
                 |-- index.adoc (new article/plaeholder, incl. content&Maintenance/design )
                 |-- content/
                 |        |-- index.adoc. (== current 'Contribute to Fedora Documentation')
                 |        |-- Create a new documentation module
                 |        |-- {all the other articles on this level}
                 |        |-- Howto guides/
                 |        |        |-- { all 3 articles of this section}
                 |        |-- Docs style guide
                 |        |-- Antora & ASCIIDoc for Fedora
                 |        |        |-- { all articles of thes section }
                 |        |-- Working with translations
                 |        |-- Legacy guides/
                 |                |-- { all the legacy guides }
                 |
                 |-- maintenance/
                         |-- index.adoc (== 'Contribute to keeping Docs up and running')
                         |-- Design the user interface for Docs.adoc

We want to move the complete Docs Contributors Guide, which is currently integrated in the Docs Team documentation, into a separate module on the same level as the root module. The reason is, we want to be able to place the Docs Contributors Doc on the Docs landing page. New structure: ``` modules -|-- root/ |-- contributing/ (naming about 2 years ago before we moved it into team docs | |-- index.adoc (new article/plaeholder, incl. content&Maintenance/design ) |-- content/ | |-- index.adoc. (== current 'Contribute to Fedora Documentation') | |-- Create a new documentation module | |-- {all the other articles on this level} | |-- Howto guides/ | | |-- { all 3 articles of this section} | |-- Docs style guide | |-- Antora & ASCIIDoc for Fedora | | |-- { all articles of thes section } | |-- Working with translations | |-- Legacy guides/ | |-- { all the legacy guides } | |-- maintenance/ |-- index.adoc (== 'Contribute to keeping Docs up and running') |-- Design the user interface for Docs.adoc ```

👍 1

pboy added the

Contributors' Guidance

Improve written Material

labels

2026-06-30 11:02:05 +00:00