Difference between revisions of "User talk:Inkyfingers/Getting Started(1)"

From Sugar Labs
Jump to navigation Jump to search
(Use of English: almost-a-tutorial, not in my dictionary. Do you mean insightful walk-through?)
(adjust error)
 
(14 intermediate revisions by 3 users not shown)
Line 15: Line 15:
 
: A tutorial is good, but should be entered by choice, as the style is so different. Perhaps the declarative guidance appears and it is followed by a collapsed tutorial section or a link to a section on a separate page of tutorials. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
 
: A tutorial is good, but should be entered by choice, as the style is so different. Perhaps the declarative guidance appears and it is followed by a collapsed tutorial section or a link to a section on a separate page of tutorials. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
 
::My model: Switch on, here is the manual. The sane thing to do is to read the manual. In reading on the reader trusts the editor to provide an insightful walk-through. The product is a children's educational tool. An editor is required to provide appropriate content. --[[User:Inkyfingers|Inkyfingers]] 04:41, 7 December 2011 (EST)
 
::My model: Switch on, here is the manual. The sane thing to do is to read the manual. In reading on the reader trusts the editor to provide an insightful walk-through. The product is a children's educational tool. An editor is required to provide appropriate content. --[[User:Inkyfingers|Inkyfingers]] 04:41, 7 December 2011 (EST)
 +
::: Please forgive my misunderstanding of your intention. Although I suggested a similar model [[Talk:Crib_Sheet_day1#Comments|in this comment]], the wiki ''Get started'' pages serve in a different context, but could integrate tutorials in secondary views. --[[User:FGrose|FGrose]] 19:10, 7 December 2011 (EST)
 
I have also preferred to avoid hiding links that go off-site. My reasons are to avoid distraction, simplicity, and orientation.
 
I have also preferred to avoid hiding links that go off-site. My reasons are to avoid distraction, simplicity, and orientation.
 
: This can be useful in context, however, the standard wiki style includes a large number of hyperlinks for reader-directed, non linear navigation, best determined by the reader, as is common on [[wikipedia:Wikipedia|Wikipedia]] ([[Wikipedia:Wiki#Navigation|described here]]). Within this context, one learns to follow hyperlinks only for a reason, rather than because they have been presented.  Within a tutorial, one presumably submits oneself to the navigation of the author, so links that may distract would be carefully chosen. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
 
: This can be useful in context, however, the standard wiki style includes a large number of hyperlinks for reader-directed, non linear navigation, best determined by the reader, as is common on [[wikipedia:Wikipedia|Wikipedia]] ([[Wikipedia:Wiki#Navigation|described here]]). Within this context, one learns to follow hyperlinks only for a reason, rather than because they have been presented.  Within a tutorial, one presumably submits oneself to the navigation of the author, so links that may distract would be carefully chosen. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
 +
:: The links to the Floss manual seem entirely appropriate. The link to [[olpc:Sugar_Control_Panel#Access_the_interface]] is the only link with which I have difficulty. I see that http://en.flossmanuals.net/sugar/ch007_home-view/ would not make a good alternative. The other bug with the "current" version, is that reference to USA keyboard is '''hidden''' on opening. [[Sugar on a Stick/Explore]] is direct and helpful in addressing the keyboard issue to users outside the USA. My first motivation [[Talk:Getting_Started]] line 1, was to highlight this helpfulness,  the "current" version obscures. --[[User:Inkyfingers|Inkyfingers]] 18:12, 7 December 2011 (EST)
 +
::: My attempt was to show how to reach the My Settings controls as fixed content under the Configuration heading (with a link available for more complete visualization and instructions), and then allow the readers to reveal additional topics that interest them. Keyboard layout, Internet, Frame, ... could each have expandable sections. --[[User:FGrose|FGrose]] 19:10, 7 December 2011 (EST). I agree, that is sound. --[[User:Inkyfingers|Inkyfingers]] 06:48, 8 December 2011 (EST)
 +
To clarify or repeat - keyboard settings is critical to successful deployment for non-USA users. --[[User:Inkyfingers|Inkyfingers]] 06:48, 8 December 2011 (EST)
  
−
I think it is interesting to share that pre-production I followed [[How to present Sugar]]. As my idea developed /Presentation was aimed at parents ( my children), and /Explore at very young new learners, (their children). I then edited out some more "clunky" parts to try to avoid addressing any reader in a pejorative way and out of self-consciousness! I notice I have completely removed any sense that a parent can follow /Presentation in their own time while a child could work through /Explore at their own speed. I am not an Adobe fan but I find a .pdf presentation useful because its stability aids orientation.  
+
Please compare:
−
 
+
# If you need to change this, you need to right click the http://wiki.laptop.org/images/b/ba/Xo_s.png Learner icon and click on '''My Settings''' on the pop-up menu. [[olpc:Sugar_Control_Panel#Access_the_interface|If required, there is help here]].
−
In my experience well written copy addressed to an eight year old can be understood by most adults and participating children, and easily speed read by an expert.--[[User:Inkyfingers|Inkyfingers]] 04:34, 6 December 2011 (EST)
+
# Hover the pointer or right click the Learner icon[[File:learner.svg|link=|bottom]]in the Home view, and then click on the [[olpc:Sugar_Control_Panel#Access_the_interface|'My Settings' item on the pop-up menu]].
−
: I suggest that this testbed page re-enter the 'Under construction' tag while more design and presentation ideas are explored. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
+
In my view, to a new learner, the second looks like an instruction to follow the link - adds complexity. --[[User:Inkyfingers|Inkyfingers]] 10:03, 12 December 2011 (EST)
−
 
+
=== linking tutorials ===
−
== Exporting files from the sugar-journal with Drag-Drop to 2nd USB-stick==
+
Take a look at my 3 new screen-shot full wiki pages: [[Sugar Creation Kit/sck/Introduction to Sugar Interface]], [[Sugar Creation Kit/sck/Connecting to the Internet]], [[Sugar Creation Kit/sck/Drag-Drop]]; I hope that this format is useful. [[User:Satellit| satellit_]] 5:47 AM 8 December 2011 (PST)
−
[[File:2nd_USB.png|500px]]
+
: Yes, the wiki can provide a good collaboration space for documentation.  We should advise the [http://www.mail-archive.com/iaep@lists.sugarlabs.org/msg12528.html XO/Sugar Manual/Help Activity team] of those and these ''Get started'' pages. --[[User:FGrose|FGrose]] 14:38, 8 December 2011 (EST)
−
:Click on Figure to enlarge it ^
+
::Done [[User:Satellit| satellit_]] 11:47 AM 8 December 2011 (PST)
−
::Note this screen-shot was Drag-Dropped to a 2nd USB-stick
+
I suggest that this testbed page re-enter the 'Under construction' tag while more design and presentation ideas are explored. --[[User:FGrose|FGrose]] 15:35, 6 December 2011 (EST)
−
::Copied from the USB to another Computer and uploaded to the Sugarlabs.wiki
 
−
::Where it was inserted into this page
 
−
 
 
−
You can import and export items from the sugar journal
 
−
with this complicated procedure :
 
−
 
−
Insert a 2nd USB
 
−
(required to be present for this to work)
 
−
highlight the desired lines in terminal or browser
 
−
click the scissors up icon (copy)  on the  top bar
 
−
open the frame (upper right corner with mouse)
 
−
click on the journal icon on to frame
 
−
move to the bottom left edge of frame
 
−
right click on  clipping icon on the left bottom edge of frame
 
−
hover on this icon select Keep which appears
 
−
retract frame
 
−
bottom bar shows journal and USB icon
 
−
drag the new clipping listed in the journal icon with mouse to the 2nd USB-stick icon now showing in bottom bar next to journal icon
 
−
hover over the USB-stick icon
 
−
remove
 
−
remove USB-stick from computer running sugar
 
−
insert USB-stick into another windows or linux computer and drag file on USB  to the desktop
 
−
(or into host system by removing and re-inserting it after exiting sugar)
 
−
open and copy this file to a paste bin application in your browser
 
−
 
−
'''Note''' this same method  '''drag-drop from a 2nd USB-stick''' can be used to export Photos from the sugar record activity
 
−
and to import/install to journal of (activity.xo) files if reversed
 
−
'''Note2 Screen capture'''
 
−
An important use case for the Keep button. How do we store just the image, without the software state? Some Activities, including Turtle Art, have a button for this purpose.
 
−
    <Alt> + 1 or <PrtScn> (when present) captures the screen and stores a screenshot in the Journal.
 

Latest revision as of 10:04, 12 December 2011

FLOSS Manuals

Please explain why we link to a separate download for .pdfs when they are available at FLOSS Manuals? --FGrose 10:49, 5 December 2011 (EST) I archived them a while ago when the web page for floss manuals was not working. (Spare local location of .pdf's) satellit_ 9:57, 5 December 2011 (PST) http://wiki.sugarlabs.org/go/Sugar_Creation_Kit#Floss_Manuals

OK. I suggest we treat it as a spare location rather than the preferred location, because, unless the backup is a mirror automatically tracking FM changes, it is a fragile storage arrangement. Bernie can advise on this.
It might be handy to have a Floss Manuals page in our wiki, which could provided a custom list of links to their .pdfs (along with a footnote about the backup location). For example,
--FGrose 14:49, 5 December 2011 (EST)
I did not know about those (Edit: at the point when this idea started). I included the directory of .pdf to illustrate how to download a file from a known directory. The exercise was quite illuminating for my tester. --Inkyfingers 18:41, 5 December 2011 (EST)

I can see the technical improvement that has been made to Getting_Started/Explore#Configuration. However please could you review User:Inkyfingers/Getting_Started(1), which I have adjusted, bearing in mind that my presentation is almost-a-tutorial and tries to avoid links off-site.

Use of English: almost-a-tutorial, is not in my dictionary. Do you mean insightful walk-through? --Inkyfingers 04:41, 7 December 2011 (EST)
A tutorial is good, but should be entered by choice, as the style is so different. Perhaps the declarative guidance appears and it is followed by a collapsed tutorial section or a link to a section on a separate page of tutorials. --FGrose 15:35, 6 December 2011 (EST)
My model: Switch on, here is the manual. The sane thing to do is to read the manual. In reading on the reader trusts the editor to provide an insightful walk-through. The product is a children's educational tool. An editor is required to provide appropriate content. --Inkyfingers 04:41, 7 December 2011 (EST)
Please forgive my misunderstanding of your intention. Although I suggested a similar model in this comment, the wiki Get started pages serve in a different context, but could integrate tutorials in secondary views. --FGrose 19:10, 7 December 2011 (EST)

I have also preferred to avoid hiding links that go off-site. My reasons are to avoid distraction, simplicity, and orientation.

This can be useful in context, however, the standard wiki style includes a large number of hyperlinks for reader-directed, non linear navigation, best determined by the reader, as is common on Wikipedia (described here). Within this context, one learns to follow hyperlinks only for a reason, rather than because they have been presented. Within a tutorial, one presumably submits oneself to the navigation of the author, so links that may distract would be carefully chosen. --FGrose 15:35, 6 December 2011 (EST)
The links to the Floss manual seem entirely appropriate. The link to olpc:Sugar_Control_Panel#Access_the_interface is the only link with which I have difficulty. I see that http://en.flossmanuals.net/sugar/ch007_home-view/ would not make a good alternative. The other bug with the "current" version, is that reference to USA keyboard is hidden on opening. Sugar on a Stick/Explore is direct and helpful in addressing the keyboard issue to users outside the USA. My first motivation Talk:Getting_Started line 1, was to highlight this helpfulness, the "current" version obscures. --Inkyfingers 18:12, 7 December 2011 (EST)
My attempt was to show how to reach the My Settings controls as fixed content under the Configuration heading (with a link available for more complete visualization and instructions), and then allow the readers to reveal additional topics that interest them. Keyboard layout, Internet, Frame, ... could each have expandable sections. --FGrose 19:10, 7 December 2011 (EST). I agree, that is sound. --Inkyfingers 06:48, 8 December 2011 (EST)

To clarify or repeat - keyboard settings is critical to successful deployment for non-USA users. --Inkyfingers 06:48, 8 December 2011 (EST)

Please compare:

  1. If you need to change this, you need to right click the Xo_s.png Learner icon and click on My Settings on the pop-up menu. If required, there is help here.
  2. Hover the pointer or right click the Learner iconLearner.svgin the Home view, and then click on the 'My Settings' item on the pop-up menu.

In my view, to a new learner, the second looks like an instruction to follow the link - adds complexity. --Inkyfingers 10:03, 12 December 2011 (EST)

linking tutorials

Take a look at my 3 new screen-shot full wiki pages: Sugar Creation Kit/sck/Introduction to Sugar Interface, Sugar Creation Kit/sck/Connecting to the Internet, Sugar Creation Kit/sck/Drag-Drop; I hope that this format is useful. satellit_ 5:47 AM 8 December 2011 (PST)

Yes, the wiki can provide a good collaboration space for documentation. We should advise the XO/Sugar Manual/Help Activity team of those and these Get started pages. --FGrose 14:38, 8 December 2011 (EST)
Done satellit_ 11:47 AM 8 December 2011 (PST)

I suggest that this testbed page re-enter the 'Under construction' tag while more design and presentation ideas are explored. --FGrose 15:35, 6 December 2011 (EST)

Retrieved from "https://wiki.sugarlabs.org/index.php?title=User_talk:Inkyfingers/Getting_Started(1)&oldid=72872"