<br><br><div class="gmail_quote">On 2 April 2011 04:04, Edward Cherlin <span dir="ltr"><<a href="mailto:echerlin@gmail.com">echerlin@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<div class="im">On Fri, Apr 1, 2011 at 14:38, Michael McAndrew<br>
<<a href="mailto:michaelmcandrew@thirdsectordesign.org">michaelmcandrew@thirdsectordesign.org</a>> wrote:<br>
> Hey there (sending to FM-discuss and civicrm-book),<br>
><br>
> Today we did a fair amount of work creating the user and administrator<br>
> exercise book for CiviCRM.  Still lots more completing of exercises and<br>
> proof reading, etc., to do but we think there is a decent structure in place<br>
> now and shouldn't be too hard to finish off.<br>
<br>
</div>Excellent.<br>
<div class="im"><br>
> We transferred the exercises (actually we are now calling them tasks for<br>
> some reason) from the wiki to the book and came up with a standard task<br>
> format, which is basically:<br>
><br>
> summary of the task<br>
> instructions on how to do the task (numbered if there are a lot of them)<br>
<br>
</div>Is this simply a do this, do this, procedural format, or do you allow<br>
for exploration and discovery? Is there any provision for<br>
collaborative exercises, where students practice taking someone's<br>
result and working with it in some other way? I have done a lot of<br>
procedural documentation as a Tech Writer in Silicon Valley, but I am<br>
working on how to help learners achieve a deeper level of<br>
understanding.<br></blockquote><div><br>The idea is that these exercises accompany a structured two day training course where we get a classroom of people together and go through the exercises.  It is an evolving format, but in the past, people have worked in groups of two or three doing these exercises on a version of CiviCRM that is set up to handle the training.  Hence they build on what they did in the previous exercises.<br>
</div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="im"><br>
> data that should be used in the task (in formatted)<br>
> space for notes (you can write on paper with a pen or pencil, FYI)<br>
> any tips about the task<br>
<br>
</div>Have you thought about making the book interactive, with links to the<br>
software?</blockquote><div><br>we hand out a link to a training site for each group of participants at the beginning of the training.<br></div><div> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
I know that this means abandoning print publication, or<br>
having two somewhat different versions. Your text says that the<br>
student will be connecting to a CiviCRM instance via the Web.<br>
Presumably a tutorial instance could be set up with links between<br>
exercise pages and prepared configurations.<br></blockquote><div><br>we've done that already :) <br></div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">

<div class="im"><br>
> The book has three sections:<br>
><br>
> intro<br>
> exercises<br>
> finding out more<br>
><br>
> The exercise section is broken down into chapters which are one-to-one with<br>
> a hands one session that we will carry out during the training.  The<br>
> chapters (h1) are further broken down into h2s to help people find their way<br>
> through the exercises.<br>
<br>
</div>This implies that the tutorial is sequential. Is that the intention?<br>
Are you able to fit all of the topics needed into one sequence?<br>
<div class="im"><br></div></blockquote><div>yes - it is sequential - they have to be done in order.<br> <br></div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="im">
> You can see the work in progress here:<br>
> <a href="http://booki.flossmanuals.net/civicrm-user-and-admin-exercises/_full/" target="_blank">http://booki.flossmanuals.net/civicrm-user-and-admin-exercises/_full/</a><br>
<br>
</div>The introductory section has no illustrations. It seems to me that we<br>
could make it much clearer with a few diagrams and screenshots.<br>
<br>
I expect to have more questions when I get deeper into the material.<br>
<div class="im"><br>
> We plan to make each task summary an h3 and then style the css with an image<br>
> to the left of the heading to show it is a task (rather than what we are<br>
> currently doing which is bolding them and sticking a image above them.<br>
><br>
> I think we'll handle the notes area by making an image with a fair amount of<br>
> vertical white space and a 'keep with before' to  avoid any nasty page<br>
> breaks and avoid any nasty page breaks).<br>
<br>
</div>"Keep with previous" actually creates nasty page breaks. You might do<br>
better to use a two-column format or just an adjustment of the margins<br>
to leave space for notes to one side of the instructions.<br></blockquote><div><br>thanks for pointers and ideas :) <br></div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">

<br>
BTW, does anybody know of a Free Software PDF editor that makes it<br>
easy to insert notes, in the manner of Adobe Acrobat?<br>
<div class="im"><br>
> It would be great if we could get some div handling or something similar for<br>
> 'data' and for 'tips' to avoid us using but I know that can be a huge pain<br>
> so not holding my breath :)<br>
><br>
> Hopefully I haven't gone into too much detail here and people are still with<br>
> me :)<br>
<br>
</div>You can't push me away with detail, no matter how others may feel. ^_^<br>
<div class="im"><br>
> Would be good to get people's feedback on what we have done so far and if<br>
> people have any time to improve what we have done that would be awesome.<br>
<br>
</div>I'll see what I can do.<br>
<div class="im"><br>
> Cheers,<br>
> Michael<br>
><br>
> --<br>
> Michael McAndrew<br>
> 07817 802299 (mobile)<br>
><br>
> Third Sector Design Ltd.<br>
> <a href="http://thirdsectordesign.org" target="_blank">http://thirdsectordesign.org</a><br>
><br>
> For support, email <a href="mailto:support@thirdsectordesign.org">support@thirdsectordesign.org</a><br>
><br>
</div><div class="im">> _______________________________________________<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><br>
><br>
><br>
<br>
<br>
<br>
--<br>
</div>Edward Mokurai (默雷/धर्ममेघशब्दगर्ज/دھرممیگھشبدگر ج) Cherlin<br>
Silent Thunder is my name, and Children are my nation.<br>
The Cosmos is my dwelling place, the Truth my destination.<br>
<a href="http://www.earthtreasury.org/" target="_blank">http://www.earthtreasury.org/</a><br>
<div><div></div><div class="h5">_______________________________________________<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><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><font style="color:rgb(102, 102, 102)" size="1"><span style="color:rgb(51, 51, 51)"></span><span style="color:rgb(51, 51, 51)">Michael McAndrew</span><br style="color:rgb(51, 51, 51)">
<span style="color:rgb(51, 51, 51)">07817 802299 (mobile)</span><br style="color:rgb(51, 51, 51)"><br style="color:rgb(51, 51, 51)"><span style="color:rgb(51, 51, 51)">Third Sector Design Ltd.</span><br style="color:rgb(51, 51, 51)">
<a href="http://thirdsectordesign.org" target="_blank"><span style="color:rgb(51, 51, 51)">http://thirdsectordesign.org</span></a><br style="color:rgb(51, 51, 51)"><br style="color:rgb(51, 51, 51)"><span style="color:rgb(51, 51, 51)">For support, email <a href="mailto:support@thirdsectordesign.org" target="_blank">support@thirdsectordesign.org</a></span></font><br>