<html>
<head>
<meta content="text/html; charset=windows-1252"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<br>
<br>
<div class="moz-cite-prefix">On 18/06/15 11:35, Anna F J Morris
wrote:<br>
</div>
<blockquote cite="mid:55829F06.9030109@phplist.com" type="cite"><br>
<ul>
<li>It's results in something quite linear</li>
<li>The beginning should be super simple - an overview of basic
functionality, orientation style.<br>
</li>
<li>The main chapters should be structured by day to day USE of
software and the building of skills, using real life examples
often.<br>
</li>
<li>We can assume that installation was done by someone else,
esp if a web-app, and put that at the end with advanced
chapters.<br>
</li>
<li>Not a single step should be skipped - every click needed
should be noted</li>
<li>The language should be relaxed, clear to second-language
English speakers (avoid metaphores) </li>
</ul>
</blockquote>
<br>
That's a really nice summary. <br>
<br>
In terms of not a single step skipped. I would agree with this
mostly for the software manuals, but I also think that there is a
good case for more general / overview guides about why to approach
problems in a certain way. <br>
<br>
Examples would be tech tools for activism & open video workbook<br>
<br>
<a class="moz-txt-link-freetext" href="http://flossmanuals.net/tech-tools-for-activism/">http://flossmanuals.net/tech-tools-for-activism/</a><br>
<a class="moz-txt-link-freetext" href="http://en.flossmanuals.net/open-video-workbook">http://en.flossmanuals.net/open-video-workbook</a> <br>
<br>
The linear / self-contained book structure, with published versions,
also really lends itself to being translated. After all it's a
bigger ask to translate a wiki. <br>
<br>
nice one<br>
Mick<br>
<br>
<pre class="moz-signature" cols="72">--
Mick Chesterman - <a class="moz-txt-link-abbreviated" href="mailto:mick@flossmanuals.net">mick@flossmanuals.net</a>
mickfuzz [skype]
@onefuzzyduck [twitter]
<a class="moz-txt-link-freetext" href="http://clearerchannel.org">http://clearerchannel.org</a> - training and freelance work
<a class="moz-txt-link-freetext" href="http://flossmanuals.net">http://flossmanuals.net</a> - Free Manuals for Free Software</pre>
</body>
</html>