Thanks for joining the Fedora Docs community. I've CC'd this reply to
the docs mailing list to let the community in on your questions. This
will ensure that we provide you with the best answers and quickly get
you up and running on the ideas and contributions you would like to
make to the Docs project.
The links I sent to the mailing list were git pull-requests for edits
I've made to a few documents. It was to let the Doc admins know the
files I edited were ready for review. The admins will either provide
feedback for further edits, or, if everything is good, merge them to
the master for publication to the docs.fedoraproject.org
There are various sub-projects to the Docs project such as Quick Docs (
), Security Related
), and more. To see
a list of these sub-projects go to https://pagure.io/projects/fedora-do
For new users I would recommend editing one of the Fedora Quick Docs
pages as the best place to start. You can clone and fork the project
via git. Check out the "_topic_map.yml" file for pages marked "FIX
as those are the ones that would need attention. There is a "How to
Help" section at https://docs.fedoraproject.org/quick-docs/en-US/index
html with instructions on how to get started.
The only tools you would need to contribute are: asciidoc (which can be
installed from the Fedora repos with 'dnf install asciidoc'), and any
text editor. The "How to Help" page I referenced above has a link to a
quick reference guide for asciidoc syntax. Also, https://pagure.io/fedo
ra-docs/quick-docs has instructions for local testing. If you use Atom
or Visual Studio Code, there are extensions available that can display
the formatted output of the asciidoc (.adoc) file you are working on.
I too do not see any links in the Fedora Docs site for cloud computing,
but I believe documentation for Fedora Cloud is currently in progress
. I'm not acquainted with this
section of the docs project, but I'm sure someone in the community
would be able to guide you along that path.
I hope this email provided you with the answers you were seeking. If
you have any questions don't hesitate to send an email to the docs
mailing list (docs(a)lists.fedoraproject.org), or you can use the
#fedora-docs IRC channel (https://webchat.freenode.net/?channels=#fedor
a-docs). You will get a faster and direct response if the community
gets your message.
Good luck and happy writing.
Do you have a pointer to a new user guide for contributing to the
project? What tools I need. What repo I should download. IA am an
DevOps SysAdmin familiar with git and markdown. I am thinking of
something small. DNF seems like a good start to figure out the tool
chain I need. See if working on documentation works for me.
I joined the doc list because I am upgrading my desktop and server
cluster to Fedora 27 and wanted to know about the Cloud Server
group. There seems to be no documentation about it. I found the
of packages it installed which was minimal. No OpenStack. It has
5 years since I have looked at OpenStack and I understand OpenStack
their own documentation. What I do not find is a Fedora Cloud
guide. Not extensive in-depth documentation but an overview of the
parts and pieces (software groups and packages) and how they fit
together. Does Fedora have a doc like this? Where should I look?
Living on the ops side of DevOps.