%BOOK_ENTITIES; ]>

Writing recipes for the Fedora Cookbook is easy! Use a provided template to get started, submit your tutorial to the Fedora Documentation team for review, and we'll publish.

Article template from the provided examples. Your favorite text editor. You can use whatever you prefer, but please save them as a plain text file instead of a binary format such as ODF A topic. You will need something to write the tutorial about! A reviewer. When you submit your tutorial, a Fedora Docs team member will help you review the content to make sure it is clear and understandable. A license. We need your permission to distribute your work and help keep it up to date.

Choose a topic. The focus of the article should be clear, and you should be able to achieve the goal in a short series of steps. If the process is complex, consider splitting into a series of smaller articles. Fedora Documentation should be only cover capabilities that Fedora can provide. Fedora is about free software, and the docs should be as free as the code. Submissions that require software not available in Fedora should be avoided. Tutorials that require software that is not permissible for Fedora cannot be accepted. Download a template from the repository maintained by the Fedora Docs team. Choose the format you like, then click plain to get it in a format you can cut and paste into an editor. An introduction. A list of ingredients required to complete the tutorial The procedural instructions. References to resources or other content on the same subject. You can submit your tutorials in any understandable format. Eventually, it will be converted to DocBook, but the content is more important than the format. Choose a format you are comfortable with. Write an introduction to your tutorial. It doesn't need to be long, but the reader should have a good idea of the results. Write an outline of the procedure you want to document. This outline doesn't need to be detailed yet, just give an overview of the steps needed. Follow your outline and fill in the details. Start with the minimum acceptable configuration, and add the minimal configuration to the ingredients list. If possible, you should use a virtual machine or a clean user account. You can miss important steps because of local changes to installed packages or user configuration files. Make sure that your directions achieve the desired result. If there are steps that would be better in a seperate recipe, you should reference the other recipe. If it doesn't exist, you can write that first or request that it be written. Update your ingredients list with the requirements you found when testing the instructions. License your content. If you have an FAS account and have agreed to the Fedora Contributor Agreement, that's good enough. This defaults to CC-BY-SA, used by most Fedora Documentation. If you want to use another license, you must declare it. The license must allow redistribution and modification, at least for non-commercial purposes. If you have questions about licensing, ask. Submit your tutorial to the Fedora Docs Quality Assurance mailing list for review. Fedora Docs volunteers will check over your tutorial and work with you to improve it. We want to teach you how to write good content, just like you want to help users with the subject of the tutorial. After the review, a Fedora Docs volunteer will help find the best place for your content. Most recipes will probably end up in the Fedora Cookbook, but you might want to write for one of the more formal Guides at The guide will also be submitted for translation, so Fedora's users around the globe can benefit. See for more information about the Fedora Localization project.

Fedora Documentation Guide