[Testing] [IAEP] I would like feedback on the ''How_to_use_the_IRC_Application'' wiki page
forster at ozonline.com.au
forster at ozonline.com.au
Tue Dec 13 18:51:48 EST 2011
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
> Thank you for your comments;
> I have tried to do some of what you requested:
> I reduced the size of the screen-shots and tried to bullet all user
> actions in a more consistent way.
>  Editing is easy:
> 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
> 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!)
> IAEP at lists.sugarlabs.org
> This mail has been virus scanned by Australia On Line
> see http://www.australiaonline.net.au/mailscanning
More information about the Testing