[documentation-guide] markup can be a separate task, mentoring is a thing to do, and friendship is important

Pete Travis immanetize at fedoraproject.org
Sun Mar 23 22:04:01 UTC 2014


commit 65eb6bafcfeefaa067e452c02cd9b311bb254e8a
Author: Pete Travis <immanetize at fedoraproject.org>
Date:   Sun Mar 23 18:03:56 2014 -0400

    markup can be a separate task, mentoring is a thing to do, and friendship is important

 en-US/community.xml |   17 ++++++++++++++++-
 1 files changed, 16 insertions(+), 1 deletions(-)
---
diff --git a/en-US/community.xml b/en-US/community.xml
index d9c23c0..569d189 100644
--- a/en-US/community.xml
+++ b/en-US/community.xml
@@ -41,7 +41,14 @@
       <listitem>
         <formalpara><title>Writing</title>
           <para>
-            Writing content can be involved, like maintaining a formal guide, or you can share short tutorials.  Other volunteers can help with reviewing and publishing your writing.
+            Writing content can be involved, like maintaining a formal guide, or you can share short tutorials.  Writing can be the most difficult part of the process, don't worry about doing everything at once. Other volunteers can help with reviewing and publishing.
+          </para>
+        </formalpara>
+      </listitem>
+      <listitem>
+        <formalpara><title>Markup</title>
+          <para>
+            Fedora Documentation is eventually saved in DocBook format. Using docbook provides structure and context, enables effective translation, and allows publishing in a variety of formats.
           </para>
         </formalpara>
       </listitem>
@@ -59,6 +66,13 @@
           </para>
         </formalpara>
       </listitem>
+      <listitem>
+        <formalpara><title>Mentoring</title>
+          <para>
+            More experienced members of the Docs community act as mentors for others.  Don't ever be afraid to ask for help from your mentor, or from anyone on the Docs team. Friendship is one of Fedora's <ulink url="https://fedoraproject.org/wiki/Foundations">Foundations</ulink>, and many have found valuable friendships in the Fedora community.
+          </para>
+        </formalpara>
+      </listitem>
     </itemizedlist>
     
   </section>
@@ -70,6 +84,7 @@
     <title>Communication</title>
     <para />
   </section>
+  
   <section id="community-office_hours">
     <title>Office Hours</title>
     <para />


More information about the docs-commits mailing list