[ubuntu-za] Documentation User Group

Gustav H Meyer ghmeyer at gmail.com
Mon Apr 6 10:34:32 UTC 2015

This is a very interesting debate.

I haven't really tried the others but so far am leaning towards
learning Sphinx as it seems relatively easy to use and looks very
powerful with the use of reStructuredText. It produces beautiful and
clean output in multiple formats but, having said that, I struggle to
see many users going down this route when they are so used to WYSIWYG
in modern word processors.

Real collaborative editing remains a challenge even on smaller
projects and the big hurdle is often not just the technology but also
the human factors. I just wish it was easy to let people unlearn the
idea of emailing bulky documents back and forth and let everyone agree
on using platform independent open standards with proper distributed
version control for documentation with the ability to use it in both
online and offline modes.


On Wed, Apr 1, 2015 at 4:19 PM, William Walter Kinghorn
<williamk at dut.ac.za> wrote:
> Hi Marius,
> There is a lot of documentation to be done, so having a place where we can
> do collaborative editing, is a good thing, and will allow us to concentrate
> on the parts that we know
> Pubsweet and Booktype, do a lot of the book formatting for us, to try out
> Booktype, look here : http://booktype-demo.sourcefabric.org/
> To look at some of the books created in Pubsweet :
> http://www.booksprints.net/books/
> To look at what Pubsweet looked like in April 2014 :
> http://www.booksprints.net/2014/04/pubsweet-enters-the-game/
> William
> ________________________________
> From: ubuntu-za-bounces at lists.ubuntu.com
> [ubuntu-za-bounces at lists.ubuntu.com] on behalf of Marius Kruger
> [amanic at gmail.com]
> Sent: 01 April 2015 12:49
> To: Ubuntu South African Local Community
> Subject: Re: [ubuntu-za] Documentation User Group
> maybe you mean WYSIWYG (What You See Is What You Get)
> in stead of GUI.
> Would it not be important to run standalone too?
> --
> ✝ Marius
> ________________________________
> "This e-mail is subject to our Disclaimer, to view click
> http://www.dut.ac.za/disclaimer"
> Disclaimer
> The information contained in this communication from the sender is
> confidential. It is intended solely for use by the recipient and others
> authorized to receive it. If you are not the recipient, you are hereby
> notified that any disclosure, copying, distribution or taking action in
> relation of the contents of this information is strictly prohibited and may
> be unlawful.
> This email has been scanned for viruses and malware, and automatically
> archived by Mimecast SA (Pty) Ltd, an innovator in Software as a Service
> (SaaS) for business. Mimecast Unified Email Management ™ (UEM) offers email
> continuity, security, archiving and compliance with all current legislation.
> To find out more, contact Mimecast.
> --
> ubuntu-za mailing list
> ubuntu-za at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-za

More information about the ubuntu-za mailing list