[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: Zachary Oglesby <zach () oglesby ! co>
Date: 2013-11-18 15:48:21
Message-ID: CABypDWNZTNeRW0EhpjHpBmCgXHReOYCQqxmvyJM16iVDY8+Pgg () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
On Mon, Nov 18, 2013 at 10:05 AM, Eric H. Christensen <
sparks@fedoraproject.org> wrote:
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.
>
>
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.
>
> 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.
>
> 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?
>
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.
> - -- Eric
>
>
[Attachment #5 (text/html)]
<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 \
href="mailto:sparks@fedoraproject.org" \
target="_blank">sparks@fedoraproject.org</a>></span> wrote:</div> <div \
class="gmail_quote"><br><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>
<div class="im"><br></div></blockquote><div><br></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>
</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>
<br>
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> </blockquote><div><br></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><br> \
</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex"> <div class="im"><br>
- -- Eric<br><br></div><div class="HOEnZb"></div></blockquote></div><br></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