<br><br><div class="gmail_quote">On Sun, Nov 22, 2009 at 8:10 PM, K. K. Subramaniam <span dir="ltr"><<a href="mailto:subbukk@gmail.com">subbukk@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 Friday 20 November 2009 11:14:34 pm Eliot Miranda wrote:<br>
> > Many steps in Squeak are simple to the point of being incredible. But the<br>
> > path<br>
> > to simplicity is complex. Documentation/ site could help by indexing<br>
> > beginner<br>
> > (Developer) videos/screencasts at the top level.<br>
> ><br>
> > Subbu<br>
><br>
> I can not disagree more. Which do you prefer, this?<br>
><br>
> <a href="http://www.extremetech.com/article2/0,1697,2119529,00.asp" target="_blank">http://www.extremetech.com/article2/0,1697,2119529,00.asp</a><br>
><br>
> or this?<br>
><br>
> <a href="http://www.youtube.com/watch?v=K9r1UAVq9AU" target="_blank">http://www.youtube.com/watch?v=K9r1UAVq9AU</a><br>
</div>Eliot,<br>
<br>
I never suggested replacing linear docs with visual docs. They are not<br>
exclusive. My suggestion was to start including short screencasts in<br>
Documentation/ page (even if it is a link to the vimeo page). Screencasts take<br>
much less effort to produce and distribute these days than linear docs so the<br>
trend is only likely to accelerate in the coming years.<br></blockquote><div><br></div><div>OK. Agreed. I should stop beating a dead horse but I'm not against visual documentation either. The examples I posted were both visual. One used text interspersed with pictures. One used video augmented with a bad rock intro, and a HAL like voice over. I know which one I prefer, which one I can index and which one is cheaper to edit. But I agree, augmenting intro doc with short videos showing screen interaction can be nice as encouragement to newbies. As long as no one expects someone to sit through a 15 minute video tutorial in which any embedded text is inaccessible, etc, etc.</div>
<div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
Subbu<br>
</blockquote></div><br>