[prev in list] [next in list] [prev in thread] [next in thread]
List: fedora-docs-list
Subject: Re: Lowering the participation barrier for Fedora Docs
From: Leslie S Satenstein <lsatenstein () yahoo ! com>
Date: 2013-11-18 21:39:34
Message-ID: 1384810774.66745.YahooMailAndroidMobile () web163002 ! mail ! bf1 ! yahoo ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
I would consider LibreOffice. We could have a master document and pre-assign the \
chapters. With markup and ability to work offline while commuting, it or a similar \
product would be beneficial for smaller docs or even for collaboration.
Sent from Yahoo Mail on Android
[Attachment #5 (text/html)]
<table cellspacing="0" cellpadding="0" border="0"><tr><td valign="top"><p dir="ltr">I \
would consider LibreOffice. We could have a master document and pre-assign the \
chapters. With markup and ability to work offline while commuting, it or a similar \
product would be beneficial for smaller docs or even for collaboration. </p> <p \
dir="ltr"><a href="http://overview.mail.yahoo.com/mobile/?.src=Android">Sent from \
Yahoo Mail on Android</a></p> </td></tr></table> <div id="_origMsg_">
<div>
<br />
<div>
<div style="font-size:0.9em">
<hr size="1">
<b>
<span style="font-weight:bold">From:</span>
</b>
Zachary Oglesby <zach@oglesby.co>; \
<br> <b>
<span style="font-weight:bold">To:</span>
</b>
For participants of the Documentation Project \
<docs@lists.fedoraproject.org>; \
<br> <b>
<span style="font-weight:bold">Subject:</span>
</b>
Re: Lowering the participation barrier for Fedora Docs \
<br> <b>
<span style="font-weight:bold">Sent:</span>
</b>
Mon, Nov 18, 2013 3:48:21 PM \
<br> </div>
<br>
<table cellspacing="0" cellpadding="0" border="0">
<tbody>
<tr>
<td valign="top"><div dir="ltr"><div \
class="gmail_extra"><div class="gmail_quote">On Mon, Nov 18, 2013 at 10:05 AM, Eric \
H. Christensen <span dir="ltr"><<a rel="nofollow" shape="rect" \
ymailto="mailto:sparks@fedoraproject.org" target="_blank" \
href="javascript:return">sparks@fedoraproject.org</a>></span> wrote:</div> <div \
class="gmail_quote"><br clear="none"><blockquote class="gmail_quote" style="margin:0 \
0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">I guess so many of us just use \
the CLI to create our works that we don't think about GUI programs. I \
couldn't tell you a single GUI program that would be good for creating/editing \
DocBook (gedit?) because I just don't use them. I'd welcome other \
people's experience with GUI tools so we can start recommending these to people. \
Same goes for Git. It really isn't that difficult to use these tools once you \
understand what's happening and why. Like I mentioned earlier, I think training \
is key here and something we're missing. Last week I started working on training \
videos that I'll continue to refine (I'm still sick so my voice isn't \
great right now). As soon as they are ready I'll start kicking them out the door \
and hope to get feedback.<br clear="none">
<div class="im"><br clear="none"></div></blockquote><div><br \
clear="none"></div><div>I think the issue is the learning curve. From my experience \
people want to join the Docs team because they see it as an easy way to contribute \
back to Fedora. Not everyone has a technical background and teaching people to use \
the tools of the trade over IRC is not always easy. A good set of tutorials would \
definitely be helpful, but I don't think we can assume that everyone that wants \
to help has the technical background to just jump in to emacs/VIM, docbook XML, and \
git. The training at FUDCon was a great idea, but that obviously will not scale. \
Mentorship is also good, but can still make someone fell like they are teaching \
themselves and someone is simply checking in on them. We need a way to teach people \
to use the tools in a way that is easy to understand and scalable. </div> <div> \
</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex;"><div class="im"> <br clear="none">
</div>There is definite overlap in some of the guides (installation, admin, and \
security to name a few). We should probably reduce that overlap and make sure the \
expectation is to find a certain piece of information in a certain guide. Getting an \
internal search engine going is also needed.<br clear="none">
<br clear="none">
There are lots things that need to be done, really. I suspect that it would be quite \
a lift to get us back to where we need to be. That said, I don't think it's \
out of the question. Would people be interested in meeting for a FAD to get some \
stuff done?<br clear="none"> </blockquote><div><br clear="none"></div><div>I think \
that is a good idea, we need to prioritize the work that needs done and figure out \
the best course of action so that content gets into the hands of people who need it. \
</div><div class="yqt3993514227" id="yqtfd83201"><div><br clear="none"> \
</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex;"> <div class="im"><br clear="none">
- -- Eric<br clear="none"><br clear="none"></div><div \
class="HOEnZb"></div></blockquote></div></div><div class="yqt3993514227" \
id="yqtfd29316"><br clear="none"></div></div></div></td> </tr>
</tbody>
</table>
</div>
</div>
</div>
[Attachment #6 (text/plain)]
--
docs mailing list
docs@lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic