summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPete Travis <immanetize@fedoraproject.org>2014-03-22 00:27:43 -0400
committerPete Travis <immanetize@fedoraproject.org>2014-03-22 00:27:43 -0400
commit6594a82e0db435bdc27278016e7c55072433af25 (patch)
tree8918331ef0242b288896579060a652e1ae90cc70
parent37e7d6e93b776b9088a5a494bcb17ff453e657e4 (diff)
downloadfedora-cookbook-6594a82e0db435bdc27278016e7c55072433af25.tar.gz
fedora-cookbook-6594a82e0db435bdc27278016e7c55072433af25.tar.xz
fedora-cookbook-6594a82e0db435bdc27278016e7c55072433af25.zip
an admonition about scope
-rw-r--r--en-US/Documenting_Fedora/writing_recipes.xml13
1 files changed, 12 insertions, 1 deletions
diff --git a/en-US/Documenting_Fedora/writing_recipes.xml b/en-US/Documenting_Fedora/writing_recipes.xml
index e6653d2..58c2c87 100644
--- a/en-US/Documenting_Fedora/writing_recipes.xml
+++ b/en-US/Documenting_Fedora/writing_recipes.xml
@@ -56,7 +56,18 @@
<step>
<para>
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.
- </para></step>
+ </para>
+ <important>
+ <title>Write about Fedora!</title>
+ <para>
+ 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.
+ </para>
+ <para>
+ Submissions that require software not available in Fedora should be avoided. Tutorials that require software that is <ulink url="https://fedoraproject.org/wiki/Forbidden_itemshttps://fedoraproject.org/wiki/Forbidden_items">not permissible</ulink> for Fedora cannot be accepted.
+ </para>
+ </important>
+
+ </step>
<step>
<para>
Download a template from <ulink url="https://git.fedorahosted.org/cgit/docs/fedora-cookbook.git/tree/en-US/examples">the repository</ulink> maintained by the Fedora Docs team. Choose the format you like, then click <guilabel>plain</guilabel> to get it in a format you can cut and paste into an editor.