Tom Yes the smaller screenshots are better as per James' suggestion.
It is good if you can show the tooltip and manually add a cursor which shows the next step. I have edited the first screenshot to show what I mean. (You might want to redo it though to get consistent colours and size) I have also edited 'F3' to 'Home (or F3)' as per James' suggestion Tony > Thank you for your comments; > > I have tried to do some of what you requested: > http://wiki.sugarlabs.org/go/Sugar_Creation_Kit/sck/How_to_use_IRC > > I reduced the size of the screen-shots[1] and tried to bullet all user > actions in a more consistent way. > > [1] Editing is easy: > [[File:Screenshot_of_IRC_Join_cmd2.png|600px]] > the |xxxpx can be adjusted easily for the best size. > > Please do edit this wiki page, I value all additions and points of view. > > This page was composed last night, after a request for such a guide on > #sugar IRC > > Cordially > > Tom Gilliard > satellit_ on #sugar > > (I was trained as a geological oceanographer, so my writing style may > reflect this.) > > On 12/13/2011 02:20 PM, James Cameron wrote: > > On Tue, Dec 13, 2011 at 07:41:07AM -0800, Thomas C Gilliard wrote: > >> I just wrote this wiki page: > >> http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#How_to_use_the_IRC_Application > >> (Annotated screen shots that show you how to use the IRC application) > >> > >> My question: > >> Is this a useful way to build guides for beginners? > > No, because the way leads to a guide that is very hard to read. > > > > The text styles keep changing. Use of indentation is inconsistent. The > > images are too large and break up the flow of the text. Some bolding is > > used spuriously. The difference between user actions and software > > actions is not clear. Terms are inconsistent with Sugar design (e.g. f3 > > screen). No mention of needing an internet connection first. > > > > These things would conspire to make it very hard for a beginner to read > > the page. > > > > You might like to read an english style guide. Also try to think in > > terms your reader will understand, and each time you use a word, > > consider whether it is the right word to use. > > > >> I think as "it is a wiki" these provide a way for users to > >> participate in updating in these guides. > >> > >> I would like feedback on this project. > > Good idea. I won't edit it though, because I don't know you'd agree > > with the changes I make. ;-) > > > _______________________________________________ > IAEP -- It's An Education Project (not a laptop project!) > [email protected] > http://lists.sugarlabs.org/listinfo/iaep > > _____________________________________________________ > This mail has been virus scanned by Australia On Line > see http://www.australiaonline.net.au/mailscanning _______________________________________________ Testing mailing list [email protected] http://lists.laptop.org/listinfo/testing
