Hi Robert,
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 site.
There are various sub-projects to the Docs project such as Quick Docs ( https://pagure.io/fedora-docs/quick-docs), Security Related Documentation (https://pagure.io/fedora-docs/securityguide), Install Guides (https://pagure.io/fedora-docs/install-guide), and more. To see a list of these sub-projects go to https://pagure.io/projects/fedora-do cs/%2A.
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 ME!" 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 at https://github.com/fedora-cloud/docs. 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@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.
Regards,
Shaun Assam sassam
Do you have a pointer to a new user guide for contributing to the doc project? What tools I need. What repo I should download. IA am an old DevOps SysAdmin familiar with git and markdown. I am thinking of trying 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 install group. There seems to be no documentation about it. I found the list of packages it installed which was minimal. No OpenStack. It has been 5 years since I have looked at OpenStack and I understand OpenStack has their own documentation. What I do not find is a Fedora Cloud Computing 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?
RLH
Living on the ops side of DevOps.
On Wed, Mar 28, 2018, at 7:49 AM, Shaun Assam wrote:
Hi Robert,
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 site.
There are various sub-projects to the Docs project such as Quick Docs ( https://pagure.io/fedora-docs/quick-docs), Security Related Documentation (https://pagure.io/fedora-docs/securityguide), Install Guides (https://pagure.io/fedora-docs/install-guide), and more. To see a list of these sub-projects go to https://pagure.io/projects/fedora-do cs/%2A.
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 ME!" 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 at https://github.com/fedora-cloud/docs. 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 believe that documentation is stalled. We'd need to ask the Fedora Cloud SIG where their docs are. If they exist, we should try to make them more findable :)
regards,
bex
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@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.
Regards,
Shaun Assam sassam
Do you have a pointer to a new user guide for contributing to the doc project? What tools I need. What repo I should download. IA am an old DevOps SysAdmin familiar with git and markdown. I am thinking of trying 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 install group. There seems to be no documentation about it. I found the list of packages it installed which was minimal. No OpenStack. It has been 5 years since I have looked at OpenStack and I understand OpenStack has their own documentation. What I do not find is a Fedora Cloud Computing 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?
RLH
Living on the ops side of DevOps.
docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org
-
Brian Exelbierd -
Shaun Assam