<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:10pt"><font size="2"> Hi Pete<br>Your blog below was quite appropriate. I work in aerospace and do a fair amount<br>of writing and software development. The editing department here is also a translation<br>department as the company is a global one, dealing with Chinese, Indian dialects, French, Spanish,<br>and a slew of UN national languages. The translators want paragraphs of text. The English editor wants<br>text delivered double spaced 12 size font, with revision management enabled and comments enabled. <br>The company uses MS word, but Libreoffice, (for Fedora's purpose), would suffice.<br><br>By allowing authors to use Libreoffice, along with Libreoffice's revision management, I believe that a quality<br>product and a more easily and accurately translated source would
be generated.<br><br>Regarding installations, and expositories, there are varying levels of expertise as Fedora users. Many users,<br>from my use of forums is that they are more frequented by are beginners. They want a working Fedora distribution, <br>so that they may use the tools that are included. (from workbenches, to business software). I would say that the <br>more experienced individuals do not frequent the forums too often, as "they know it all, and what can they learn?"<br><br>Your ideas are great, I fully agree with them, but "when the only tool you have is a hammer, everything looks like a nail".<br>My view is that the tool you are using, with po files, is great for application code messages. It misses something when<br>used as the documentation preparation tool.<br><br>Can you please try this experiment. Are you able to ask an author to write his stuff with Libreoffice, and then turn on revision managment to send out
his work for comments and feedback. Lets see how that works. I would even take a page or two of text, if it is handed to me that way.<br><br>Libreoffice is not a barrier, since is is ubiquitous. <br>Regards<br><br>Leslie <br><br></font><div style="color: rgb(0, 0, 0); font-size: 13px; font-family: HelveticaNeue,Helvetica Neue,Helvetica,Arial,Lucida Grande,sans-serif; background-color: transparent; font-style: normal;"></div><blockquote style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"><div style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 10pt;"><div style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 12pt;"><div dir="ltr"><font size="2" face="Arial"> <b><span style="font-weight: bold;">Subject:</span></b> Lowering the participation barrier for Fedora Docs<br> </font> </div> <div
class="y_msg_container"><br>I took some time over the weekend to update my workstation to F20. It<br>involved performing a lot of now routine tasks; installing the package<br>set I use, pulling in the git repo I keep for $HOME, updating /etc/fstab<br>to include network shares, adding a couple polkit rules for libvirt,<br>blah blah. I'm sure we all have such a list.<br><br>These are among many routine, everyday tasks for Fedora users. The kind<br>of task that an experienced user could sit down and perform, and write<br>up a how-to for the action on the fly while they do it. The kind of task<br>that an inexperienced user would ask about on a forum, or on irc, or<br>research with relatively specific search terms. I think of this as<br>'incidental' or 'case-specific' documentation, rather than generalized<br>documentation as provided in the guides.<br><br>Our existing documentation base is *great*, and anyone who reads through<br>it all
will surely come out with the ability to fill in the gaps and<br>handle case-specific problems. We're teaching techniques and tools, not<br>execution. However, between the broad nature of the guides and the SEO<br>reality of a publican site, I think we are failing to reach many users<br>that are actively looking for tutorial-format content.<br><br>Publican based guides have one major shortcoming. The barrier to entry<br>for potential contributors is high. I had a chance at Flock to have<br>some candid conversation over beer with a few folks outside of the loyal<br>Docs team, and there was a general consensus that while they might be<br>willing to write some *incidental* documentation - again, my term -<br>contributing to a guide was an ordeal they didn't have time for. We've<br>seen this repeatedly with new contributors as well, people who start out<br>with enthusiasm that fades when there isn't work that they can easily<br>drop into.
Contributing to a guide is *not* a casual endeavor; it<br>requires us to not only learn docbook and the subject matter, but to be<br>entirely self-motivated while working on a project owned by someone<br>else. Fitting into the workflow is just as intimidating as learning the<br>tools, if not more.<br><br>I would like to try something different. We should have a product that<br>leverages the experience and quality of our seasoned contributors and<br>enables new contributors to get started. We should have something that<br>helps inexperienced, impatient users. We should enable the Fedora<br>community at large to participate in our efforts, and I think that means<br>coming to them as much as them coming to us. If we have something<br>easier to contribute to, more contributors will likely follow, and then<br>contributors and content for guides as well.<br><br>I've set up a quick demonstration[1] of some software that I think
will<br>address these concerns, a python application called "Nikola"[2]. I have<br>a package review in progress for it, and have already packaged some<br>dependencies. Briefly, it takes plain text files with ReStructuredText<br>or Markdown and transforms them into fully themed static websites. It<br>hooks in to transifex nicely as well. Take a look, you'll find a post<br>detailing how the implementation might work, and a post for the kind of<br>content I envision putting there.<br><br>[1] <a href="http://appliance.randomuser.org/solutions/" target="_blank">http://appliance.randomuser.org/solutions/</a><br>[2] <a href="http://www.getnikola.com/" target="_blank">http://www.getnikola.com/</a><br><br>-- <br>-- Pete Travis<br> - Fedora Docs Project Leader<br> - 'randomuser' on freenode<br> - <a ymailto="mailto:immanetize@fedoraproject.org" href="mailto:immanetize@fedoraproject.org">immanetize@fedoraproject.org</a><br><br><br>-- <br>docs mailing list<br><a
ymailto="mailto:docs@lists.fedoraproject.org" href="mailto:docs@lists.fedoraproject.org">docs@lists.fedoraproject.org</a><br>To unsubscribe:<br><a href="https://admin.fedoraproject.org/mailman/listinfo/docs" target="_blank">https://admin.fedoraproject.org/mailman/listinfo/docs</a><br><br></div> </div> </div> </blockquote><div></div> </div></body></html>