I favour a wiki approach to documentation. I also favour using libreOffice with the "Produce Docbook" output format.
I wrote "This is a test of docbook output" with LibreOffice and saved the output in docbook format.
This is the resulting output
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article lang="">
<para>This is a test of docbook output</para>
<para/>
</article>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article lang="">
<para>This is a test of docbook output</para>
<para/>
</article>
Writing with WYSIWYG (What you see is what you get), is great for technical writing. As well, the markup and collaboration tools in LibreOffice are what appeals to many individuals.
Translation from English to other languages is made easier by using web services from Google, Microsoft and others.
I would also suggest you compare these two links.
Fedora
SUSE
Which of the two is more inviting and easier to use?
Regards
Leslie
Leslie
Mr. Leslie Satenstein
Montréal Québec, Canada
From: Matthew Miller <mattdm@xxxxxxxxxxxxxxxxx>
To: For participants of the Documentation Project <docs@xxxxxxxxxxxxxxxxxxxxxxx>
Sent: Wednesday, February 10, 2016 5:22 AM
Subject: Re: Fedora Publishing
On Wed, Feb 10, 2016 at 10:20:10AM +1000, Jeff Fearn wrote:
> You are comparing places where communities create content to a place
> communities publish content.
Sure, fair enough. And, yeah, kudos to Ubuntu community docs too.
> > a forum -- and Ask Fedora is less successful because it _is_ a forum
> > which happens to have a UI which mimics the surface-level appearance of
> > Stack Exchange.
> Can you name any sites for generating documentation content that is
> more, or even as, successful as the Arch or Ubuntu wikis?
Well, again, Stack Exchange. Take a look at
http://unix.stackexchange.com/questions?sort=frequent
> What kind of docs are the best for Fedora users?
> IMO the majority of content would be short articles, straight to the
> point, simple language, with some basic examples.
+1 to both the question and answer here. That makes +2, I guess. :)
--
Matthew Miller
<mattdm@xxxxxxxxxxxxxxxxx>
Fedora Project Leader
--
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
http://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
-- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: http://lists.fedoraproject.org/admin/lists/docs@xxxxxxxxxxxxxxxxxxxxxxx
