<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Verdana;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p
{mso-style-priority:99;
mso-margin-top-alt:auto;
margin-right:0cm;
mso-margin-bottom-alt:auto;
margin-left:0cm;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
p.style1, li.style1, div.style1
{mso-style-name:style1;
mso-margin-top-alt:auto;
margin-right:0cm;
mso-margin-bottom-alt:auto;
margin-left:0cm;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
span.style11
{mso-style-name:style11;
font-family:"Times New Roman",serif;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-GB" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">Hi there,
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">This is a great idea. Here’s a suggested way to go about it but just a suggestion.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">I’ve cloned the out of date manual here
<a href="http://write.flossmanuals.net/floss-manuals/">http://write.flossmanuals.net/floss-manuals/</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">To here
<a href="http://write.flossmanuals.net/flossmanuals">http://write.flossmanuals.net/flossmanuals</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">I’ve added a chapter at the end with the updated workflow in a nutshell.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">The manual is VERY out of date and hasn’t been on the front page for a while but we can use this as a base and a way to work out what
is still relevant or what needs re-doing. <br>
<br>
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">I’ve also created a gitlab repo which we can use as an issue tracker / wiki to help communication if there is more detail than is appropriate
for this list but for the moment let’s use this list for communication. <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">Please let me know if the permissions are appropriate and if people want to be admins on this.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><a href="https://gitlab.com/flossmanuals/fm_booktype">https://gitlab.com/flossmanuals/fm_booktype</a><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">Thanks<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US">Mick<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<div>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Mick Chesterman<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Educational Innovation and Enterprise Tutor &
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">EdLab Project Developer
</span><span style="color:#44546A"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Department of Childhood, Youth and Education Studies.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Manchester Metropolitan University
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Web:
</span><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#44546A"><a href="http://edlab.org.uk/"><span style="color:#44546A">http://edlab.org.uk</span></a> / Twitter: @EdLabMMU<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial",sans-serif;color:#44546A">Phone: 0161 2472060<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#44546A"><o:p> </o:p></span></p>
<p class="MsoNormal"><i><span style="font-size:10.0pt;font-family:"Calibri",sans-serif;color:#44546A">Please note: My working days are Monday, Tuesday, Wednesday and Thursday<o:p></o:p></span></i></p>
</div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D;mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0cm 0cm 0cm 4.0pt">
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0cm 0cm 0cm">
<p class="MsoNormal"><b><span lang="EN-US" style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span lang="EN-US" style="font-size:11.0pt;font-family:"Calibri",sans-serif"> Discuss [mailto:discuss-bounces@lists.flossmanuals.net]
<b>On Behalf Of </b>William Walter Kinghorn<br>
<b>Sent:</b> 03 January 2018 05:02<br>
<b>To:</b> discuss@lists.flossmanuals.net<br>
<b>Subject:</b> Re: [FM Discuss] Hi folks<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal" style="margin-bottom:12.0pt">Hi All, Greg, Matt,<br>
<br>
I am one of those who wants to do Manuals, but don't know how/where to start<br>
<br>
Matt, you say that you have Technical Writing and Copy Editing skills, could you possibly start a manual (or 2) that will help me (us, as there are possibly more than just me) to get ourselves going<br>
<br>
Similar to<br>
GSoC Student Guide : <a href="http://write.flossmanuals.net/gsocstudentguide/what-is-google-summer-of-code/" target="_blank">
http://write.flossmanuals.net/gsocstudentguide/what-is-google-summer-of-code/</a><br>
and<br>
GSoC Mentors Manual : <a href="http://write.flossmanuals.net/gsoc-mentoring/about-this-manual/" target="_blank">
http://write.flossmanuals.net/gsoc-mentoring/about-this-manual/</a><br>
<br>
Possible titles:<br>
Technical Writing for FLOSS projects<br>
Which can be broken up into 2 projects<br>
Writing Technical Documents<br>
Writing Everyday use Documents<br>
Copy Editing for FLOSS projects<br>
<br>
Often FLOSS software projects, have documentation from a Technical perspective, not how to use the software in everyday use<br>
<br>
also: How to update the manual ( Maintenance )<br>
<br>
Another document could be:<br>
Why would you write Documentation for FLOSS Manuals<br>
Have a intro, then get authors of existing FLOSS Manuals to give their take on why they wrote a manual<br>
<br>
Thanks<br>
William<br>
________________________________________<br>
From: Discuss <<a href="mailto:discuss-bounces@lists.flossmanuals.net">discuss-bounces@lists.flossmanuals.net</a>> on behalf of Gregory Pittman <<a href="mailto:gpittman@iglou.com">gpittman@iglou.com</a>><br>
Sent: 03 January 2018 02:41<br>
To: <a href="mailto:discuss@lists.flossmanuals.net">discuss@lists.flossmanuals.net</a><br>
Subject: Re: [FM Discuss] Hi folks<br>
<br>
On 01/02/2018 06:36 PM, M R wrote:<br>
> Hi Greg (and whomever else):<br>
><br>
><br>
> Thanks. One of the follow-up questions I had is about the relationship<br>
> between a given Floss documentation project and the 'official'<br>
> documentation supported by that software's own organization. Two<br>
> examples (since I happen to be familiar with these tools): Audacity and<br>
> Blender. Both of these organizations have documentation sites (online<br>
> manuals, wikis, tutorial pages) that are far more detailed and<br>
> comprehensive (not to mention more current to latest releases) than the<br>
> respective Floss doc projects. I'd add the same for GIMP, actually. So<br>
> on the one hand, this offers a great deal of scope for adding more<br>
> detail, additional chapters etc to the relevant Floss books. On the<br>
> other hand, it somewhat begs the question of why we'd be doing this in<br>
> the first place? Some of the Floss doc projects I've seen are not<br>
> specific to a particular technology, or focus on some niche use of that<br>
> technology, so in those cases they're clearly not duplicating other doc<br>
> efforts elsewhere. But when it comes to basic user manuals on tools<br>
> that are already very richly documented....I am just curious about who<br>
> is reading the Floss documentation vs the official documentation. For<br>
> me personally, Floss is promising as a way to build up a technical<br>
> writing portfolio, so I'm happy to have the opportunity to add a few<br>
> chapters to the Blender or Audacity or GIMP books, or indeed maybe write<br>
> a whole manual for Unity3D, which is an open-source tool I know pretty<br>
> well and not yet represented on Floss. But I do have to wonder who<br>
> might actually *read* such docs, as opposed to simply going to the<br>
> makers' own documentation.<br>
><br>
><br>
> I'd be interested in answers from anyone on the list. It's clear that<br>
> the original Floss project in the late aughts had an important place in<br>
> open-source documentation, esp in Dutch and other non-English European<br>
> languages. 10 years on, I'm not as certain. But I'm very open to being<br>
> convinced.<br>
><br>
<br>
I'm hoping there will be plenty of answers other than mine. To some<br>
extent, flossmanuals fills a need where no good manuals exist. Beyond<br>
that, I've seen a number of comprehensive manuals associated with<br>
projects that are hard to absorb as a new user. There may be a need for<br>
a particular point of view. Part of what you need to decide is whether<br>
you think that something you're working on fills a need.<br>
<br>
Personally, I'm involved with the Scribus project. There is an online<br>
manual that comes with it, a wiki, and Christoph Schäfer and I wrote<br>
what's been dubbed the "Official Manual", which is/was a physical book,<br>
and it cost money to purchase. Meanwhile there was a group of French<br>
speakers who got together and wrote a flossmanual, Scribus. I liked the<br>
approach, focusing on taking a user through one or more projects with<br>
Scribus, so I translated it into English for flossmanuals.<br>
<br>
One might argue that there never are too many manuals, though I would<br>
say that each should justify its existence. Also, existing manuals<br>
become dated. The one that Christoph and I wrote in 2009 is now in many<br>
ways outmoded by new developments in Scribus.<br>
<br>
Greg<br>
_______________________________________________<br>
Discuss mailing list<br>
<a href="mailto:Discuss@lists.flossmanuals.net">Discuss@lists.flossmanuals.net</a><br>
<a href="http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net" target="_blank">http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net</a> - you can unsubscribe here<br>
<br>
<br>
________________________________<br>
<br>
"This e-mail is subject to our Disclaimer, to view click <a href="http://www.dut.ac.za/disclaimer%22" target="_blank">
http://www.dut.ac.za/disclaimer"</a><br>
<br>
<o:p></o:p></p>
<p><b><span style="font-size:10.0pt;font-family:"Verdana",sans-serif;color:#666666">Disclaimer</span></b><span style="font-size:10.0pt;font-family:"Verdana",sans-serif;color:#666666">
<o:p></o:p></span></p>
<p><span style="font-size:8.0pt;font-family:"Verdana",sans-serif;color:#666666">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.
<br>
<br>
This email has been scanned for viruses and malware, and automatically archived by
<b>Mimecast SA (Pty) Ltd</b>, an innovator in Software as a Service (SaaS) for business.
<b>Mimecast Unified Email Management </b></span><span class="style11"><b><span style="font-size:8.0pt;color:#666666">™</span></b></span><b><span style="font-size:8.0pt;font-family:"Verdana",sans-serif;color:#666666"> (UEM)</span></b><span style="font-size:8.0pt;font-family:"Verdana",sans-serif;color:#666666">
offers email continuity, security, archiving and compliance with all current legislation. To find out more,
<a href="http://www.mimecast.co.za/uem" target="_blank">contact Mimecast</a>. <o:p>
</o:p></span></p>
</div>
</div>
"Before acting on this email or opening any attachments you should read the Manchester Metropolitan University email disclaimer available on its website http://www.mmu.ac.uk/emaildisclaimer "
</body>
</html>