Lowering the participation barrier for Fedora Docs
Jérôme Fenal
jfenal at gmail.com
Tue Nov 19 00:09:29 UTC 2013
2013/11/19 Pete Travis <me at petetravis.com>:
> On 11/18/2013 04:53 PM, Eric H. Christensen wrote:
>> On Mon, Nov 18, 2013 at 01:39:34PM -0800, Leslie S Satenstein wrote:
>> > 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.
>>
>> With the exception of your suggestion of LibreOffice the rest is
>> exactly what we do right now. I see the biggest problem is creating
>> source. Most(?) contributors would either use vi(m) or emacs (or
>> similar) to create the source. There are other options as well,
>> however. gedit would be one of those programs that would work quite
>> well as a GUI text editor. LibreOffice Writer seems a bit heavy for
>> writing source, though.
>>
>> I just did a quick check and it appears that LibreOffice Writer *can*
>> save in the DocBookXML format although it's rendering is lacking. I'm
>> not sure it can truly support DocBookXML. Pasting source into Writer
>> and then saved as DocBookXML came out badly. Working with something
>> that isn't trying to do so much for you is better for writing code.
>>
>> -- Eric
>>
>> --------------------------------------------------
>> Eric "Sparks" Christensen
>> Fedora Project
>>
>> sparks at fedoraproject.org - sparks at redhat.com
>> 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1
>> --------------------------------------------------
>
> Of course, that doesn't mean that we can't accept content that isn't
> marked up in a given file format. If someone wants to take the time to
> write an article, but they're only willing to email it to the list in
> .odf, fine. I might be willing to convert it to docbook and fit it into
> a guide for a new contributor, while they learn the ropes - within
> reason. Converting things repeatedly back and forth between any two
> formats is going to degrade the work, and eat up a lot of time. This
> would be something for a mentor and protege to work out between them, at
> the mentor's discretion.
+1
That would though that the protégé is indeed _willing_ to learn how to
write DocBook content.
More information about the docs
mailing list