Sugar Labs - User contributions [en]

Features/Introduction Tutorial

2010-04-26T13:53:56Z

ErickLavoie: /* Documentation */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: Undefined
* Last updated: 04-26-2010
* Percentage of completion: Suspended

Note: Due to a higher than expected work requirement at the master level, I'll be suspending work on Tutorius indefinitely. I'll leave the page here, so that the idea is still available. Should anybody want to have more information on how Tutorius was working, I'll be glad to share.

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can reliably be integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcome, as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Source Code ==

* http://git.sugarlabs.org/projects/tutorius

Forks of sugar components:
* http://git.sugarlabs.org/projects/sugar-toolkit/repos/sugar-toolkit-tutorius
* http://git.sugarlabs.org/projects/sugar/repos/tutorius
* http://git.sugarlabs.org/projects/sugar-jhbuild/repos/tutorius

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-04-26T13:50:04Z

ErickLavoie: /* Current status */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: Undefined
* Last updated: 04-26-2010
* Percentage of completion: Suspended

Note: Due to a higher than expected work requirement at the master level, I'll be suspending work on Tutorius indefinitely. I'll leave the page here, so that the idea is still available. Should anybody want to have more information on how Tutorius was working, I'll be glad to share.

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can reliably be integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcome, as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

File:Introduction Tutorial Desktop.svg

2010-03-14T05:28:01Z

ErickLavoie: Mock up for a Tutorial shown on the Desktop. Autor: Erick Lavoie

Mock up for a Tutorial shown on the Desktop.

Autor: Erick Lavoie

Features/Introduction Tutorial

2010-03-14T05:21:50Z

ErickLavoie: /* Scope */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can reliably be integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcome, as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T05:20:36Z

ErickLavoie: /* Detailed Description */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcome, as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T05:18:54Z

ErickLavoie: /* Tasks */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcome, as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T05:17:50Z

ErickLavoie: /* Sugar Modifications */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The tutorius service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T05:16:43Z

ErickLavoie: /* Sugar Modifications */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base to the following files:
* sugar:bin/sugar-session (Add the tutorius service)
* sugar:src/jarabe/frame/frame.py (Add an Overlay and a Probe)
* sugar:src/journal/journalactivity.py (Add a Probe)
* sugar-toolkit:src/sugar/activity/activity.py (Add a Probe)
* sugar-toolkit:src/sugar/graphics/window.py (Add an Overlay)

In addition to the previous modifications:
* The tutorius files should be found under the sugar.tutorius module.
* Some icons will be added.
* The tutorial will be stored under ./sugar/default/tutorius in the user home directory.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T04:59:43Z

ErickLavoie: /* Scope */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T04:57:44Z

ErickLavoie: /* UI Design */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the place she was when she started the tutorial.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T04:56:01Z

ErickLavoie: /* Sugar Modifications */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays, and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial/Overlay

2010-03-14T04:53:22Z

ErickLavoie:

Conceptually, the Overlays should be seen as additional layers in the desktop rendering, as shown in the following diagram. An explanation of the expected behavior for each layer follows.

[[File:Introduction Tutorial Overlayer.svg | center | 700px]]

Currently, the behavior of the Sugar Shell exhibits an implicit 3 layer structure. The Activity/View displays things on layer "5". Sometimes, like for Journal entries, a popup menu will show up at layer 3. The Frame still show up on top of that pop-up at layer 2. To allow showing tutoring elements we need at least two other layers, one for the Frame (1) and one for Activities/Views (4). In the future, we might even like to have another Layer to display tutoring elements on top of popup menus but for now those are not strictly needed. The Frame Overlay should hide and show with the Frame. Each Activity and View should have its own Overlay that would also hide and show with it.

The order of the layers should stay the same, even if the Frame is shown/hidden and even if Views/Activities are switched.

=== Issues ===

The main problem we had trying to implement that layering is caused by the relative order of windows used by GTK. It is possible to add a constraint on a window so that it always shows on top of another but we haven't found a way to force a window to be "sandwiched" between two others. From the little experiments we did, it seems that sometimes, windows are fighting to be on top. Also, when switching views, the corresponding overlays would simply disappear. We guess the ordering of the windows was not preserved. I guess there might be a way to achieve it using Composition but at this point, I don't know if it is supported by Sugar and how it should be implemented. I will have a second try at this in the next weeks. In the meantime, if anyone has an idea how to implement it is welcome to add a code sample/patch on this page.

Also, the extra windows induced by overlays are seen as "Activities" in the activity tray (grey dots). I have not yet found a way to prevent those from being displayed. Any suggestion is welcomed.

Features/Introduction Tutorial/Overlay

2010-03-14T04:13:05Z

ErickLavoie: Created page with ' 700px'

[[File:Introduction Tutorial Overlayer.svg | center | 700px]]

File:Introduction Tutorial Overlayer.svg

2010-03-14T04:07:42Z

ErickLavoie: uploaded a new version of "File:Introduction Tutorial Overlayer.svg": Fixed a rendering issue for a text box

File:Introduction Tutorial Overlayer.svg

2010-03-14T04:06:02Z

ErickLavoie: {{PD-self}}

Features/Introduction Tutorial

2010-03-14T03:13:22Z

ErickLavoie: /* Benefit to Sugar */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having an interactive tutorial.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T03:11:02Z

ErickLavoie: /* UI Design */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T03:07:44Z

ErickLavoie: /* UI Design */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial and return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

User:ErickLavoie

2010-03-14T03:04:44Z

ErickLavoie: /* Short Bio */

email: User name in lower case @gmail.com

=== Short Bio ===

Erick is currently pursuing a Master degree at [http://www.umontreal.ca Université de Montréal] on P
programming language design and implementation. During the last year, as part of his final project of Computer Engineering at [http://www.usherbrooke.ca Université de Sherbrooke], he was part of a team that has developed a prototype tutorial system for Sugar, [http://www.tutorius.org Tutorius ].

He is currently working part-time on merging the work done to the official release of Sugar.

User:ErickLavoie

2010-03-14T03:04:19Z

ErickLavoie: /* Short Bio */

email: User name in lower case @gmail.com

=== Short Bio ===

Erick is currently pursuing a Master degree at [http://www.umontreal.ca | Université de Montréal] on P
programming language design and implementation. During the last year, as part of his final project of Computer Engineering at [http://www.usherbrooke.ca | Université de Sherbrooke], he was part of a team that has developed a prototype tutorial system for Sugar, [http://www.tutorius.org | Tutorius ].

He is currently working part-time on merging the work done to the official release of Sugar.

User:ErickLavoie

2010-03-14T03:03:41Z

ErickLavoie: Created page with 'email: User name in lower case @gmail.com === Short Bio === Erick is currently pursuing a Master degree at Université de Montréal on P programm…'

email: User name in lower case @gmail.com

=== Short Bio ===

Erick is currently pursuing a Master degree at [[http://www.umontreal.ca | Université de Montréal]] on P
programming language design and implementation. During the last year, as part of his final project of Computer Engineering at [[http://www.usherbrooke.ca | Université de Sherbrooke]], he was part of a team that has developed a prototype tutorial system for Sugar, [[http://www.tutorius.org | Tutorius ]].

He is currently working part-time on merging the work done to the official release of Sugar.

Features/Introduction Tutorial

2010-03-14T01:14:16Z

ErickLavoie: /* Tasks */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Translate the tutorial in French
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T01:13:29Z

ErickLavoie: /* Tasks */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an [[Features/Introduction_Tutorial/Script | exact script]] for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T01:12:42Z

ErickLavoie: /* Scope */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

Most of the work has already been done as part of the Tutorius project that ended on December 2009. However, there is still some work to do before the existing system can be reliably integrated to Sugar. The modifications to Sugar as well as the work to be done is outlined below.

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an exact script for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T01:08:31Z

ErickLavoie: /* Tasks */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
# Define an exact script for the introduction tutorial
# Rebase the existing Tutorius code base on top of Sugar 0.88
# Create a reliable [[Features/Introduction_Tutorial/Overlay | Overlay]] for all the different Views and the Frame
# Make the Message Bubble position relative to the screen size
# Make sure the current localization mecanism is reliable
# Add the logging screen option (See UI Mocks)
# Add the option item to replay the introduction tutorial (See UI Mocks)
# Produce a tutorial
# Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T00:54:39Z

ErickLavoie: /* Scope */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===
* Define an exact script for the introduction tutorial
* Rebase the existing Tutorius code base on top of Sugar 0.88
* Create a reliable Overlay for all the different Views and the Frame
* Make the Message Bubble position relative to the screen size
* Make sure the current localization mecanism is reliable
* Add the logging screen option (See UI Mocks)
* Add the option item to replay the introduction tutorial (See UI Mocks)
* Produce a tutorial
* Write documentation for the translation team

The only risky item is the creation of a reliable Overlay for the different Views. For a technical description of what it involves, see [[Features/Introduction_Tutorial/Overlay]]. Any help from GTK gurus in the community is welcomed as our last attempt at this was unsuccessful.

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T00:35:49Z

ErickLavoie: /* Scope */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface.

The proposal aims at giving an overview of the Frame, the different Views, the Journal, Browse and Write in a single tutorial.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
This feature should lower the barrier of entry to Sugar by making it easier to learn the platform by having to resort less to external documentation.

As discussed with Gerald Ardito, picking up Activities seems to work well for most students. However, getting used to the specific idioms of Sugar requires more efforts and therefore would benefit from having tutorials.

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

=== Sugar Modifications ===
The major changes to Sugar consist in introducing two new concepts, Probes and Overlays and an additional service in the sugar-session.

Probes allow obtaining events from Activities/Shell and the execution of arbitrary actions from a separate process. This ability should be reviewed in light of the security policy of Sugar.

Overlays are Layouts or Windows used to draw custom graphics on top of Activities, the Frame, the Journal or any Sugar View. A more complete description for Probes and Overlays is given in the Tutorius Architecture document referred in the Documentation section.

The service in the sugar-session adds an Engine to execute tutorials, a registering mecanism to register and unregister Probes when Activities are started and stopped and a dbus interface to start and stop tutorials.

Those changes involve modifications of less than 100 lines of code in the existing Sugar code base but add a number of new files and concepts.

=== Tasks ===

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''
This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally. At any time during the tutorial, the user can press the Stop button to interrupt the current tutorial an return to the original place where she was at first.

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
The tutorial won't affect the regular workflow or experience for the platform other than providing a tutorial on the first connexion.

== Dependencies ==
None.

== Contingency Plan ==
Revert to the previous release behavior.

== Documentation ==
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTF0dzMyNGdnag&hl=en (Meeting with Gerald Ardito and John Tierney)
*http://docs.google.com/Doc?docid=0AVT_nzmWT2B2ZGN3dDd2MzRfNTBka3J4bW1kaA&hl=en (Tutorius Engine States)

The following document provides a high-level view of the Tutorius Architecture. The original system was more powerful since it allowed Creation and Sharing of tutorials from within Sugar also. However, for the purpose of this feature proposal and to ease integration, only the Execution of tutorials will be considered. For the time being, any reference to the Store, the Workshop, the Creator and the Remote may safely be ignored. They are kept in case a further integration of those tools is accepted by the community in a later release.

The execution scenarios presented are not completely up-to-date and will be revised in the next weeks. For the time being, the most interesting part should be the component diagrams and descriptions.
*http://docs.google.com/Doc?docid=0ARkLUElWcqxDZGdkOWo3c2ZfOWdqeGtyZmY2&hl=en#Components_2405436521573161_98 (Tutorius Architecture)

* http://www.tutorius.org (Website for the project that ended on December 2009)

== Release Notes ==
A default interactive tutorial is provided on the first login to help familiarize a new user to Sugar. This tutorial can also be replayed anytime from the option menu.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-14T00:02:43Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-14T00:02:17Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-14T00:00:19Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-13T22:34:12Z

ErickLavoie: /* Benefit to Sugar */

Features/Introduction Tutorial

2010-03-13T21:39:24Z

ErickLavoie: /* User Experience */

Features/Introduction Tutorial

2010-03-13T21:37:29Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-13T21:33:46Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-13T21:32:04Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-13T21:14:59Z

ErickLavoie: /* Documentation */

Features/Introduction Tutorial

2010-03-13T21:12:14Z

ErickLavoie:

Features/Introduction Tutorial

2010-03-13T20:52:54Z

ErickLavoie:

Features/Introduction Tutorial

2010-03-13T20:51:55Z

ErickLavoie:

Features/Introduction Tutorial

2010-03-13T20:39:19Z

ErickLavoie: /* Detailed Description */

Features/Introduction Tutorial

2010-03-13T20:37:41Z

ErickLavoie: /* Detailed Description */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
''Expand on the summary, if appropriate. A couple of sentences suffices to explain the goal, but the more details you can provide the better.''

The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface and activities. This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png
http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png
http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png
http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

On top of that, the tutorial should be designed to be robust against unscripted actions made by the user. It means that if the user clicks on any button while the tutorial is showing the different elements of the interface, the tutorial should never become out-of-sync with the state of the interface in a way that cannot be resolved by the user. The examples given previously simply rely on the user pressing the next button when she is ready to move on, therefore issues about the exact state of the interface should be avoided.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
''What is the benefit to the platform? If this is a major capability update, what has changed? If this is a new feature, what capabilities does it bring? Why will Sugar become a better platform or project because of this feature?''

''Make sure to note here as well if this feature has been requested by a specific deployment, or if it has emerged from a bug report.''

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''

== How To Test ==
{{:{{PAGENAME}}/Testing}}
== User Experience ==
''If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice.''

== Dependencies ==
''What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, does your feature depend on completion of another feature owned by someone else or that you would need to coordinate, which might cause you to be unable to finish on time? Other upstream projects like Python?''

== Contingency Plan ==
''If you cannot complete your feature by the final development freeze, what is the backup plan? This might be as simple as "None necessary, revert to previous release behaviour." Or it might not. If your feature is not completed in time, we want to assure others that other parts of Sugar will not be in jeopardy.''

== Documentation ==
''Is there upstream documentation on this feature, or notes you have written yourself? Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''

== Release Notes ==
''The Sugar Release Notes inform end-users about what is new in the release. An Example is [[0.84/Notes]]. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the release team and shipped with the release.''

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-13T20:36:20Z

ErickLavoie: /* Detailed Description */

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction_Tutorial]]

</noinclude>





== Summary ==
Provide an interactive introduction to Sugar for first-time users.

== Owner ==
* Name: [[User:ErickLavoie| Erick Lavoie]]
* Email: Name above in lowercase AT gmail.com

== Current status ==
* Targeted release: 0.90
* Last updated: 03-13-2010
* Percentage of completion: 10%

== Detailed Description ==
''Expand on the summary, if appropriate. A couple of sentences suffices to explain the goal, but the more details you can provide the better.''

The proposal consists in providing a default interactive tutorial for Sugar that will give an overview of the particularities of the Sugar interface and activities. This tutorial should be accessible from the first login screen, right after the color selection, and from the option menu:

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/login1-300x226.png" alt="login" title="login" width="300" height="226" class="aligncenter size-medium wp-image-241" />

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/options-300x225.png" alt="options" title="options" width="300" height="225" class="aligncenter size-medium wp-image-231" />

The tutorial will provide an overview of the Desktop, the Group and the Neighborhood Views as well as the Frame, the Journal, the Write and the Browse activity. Here are screenshots of what it might look like for some of them.

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/desktop-300x214.png" alt="desktop" title="desktop" width="300" height="214" class="aligncenter size-medium wp-image-227" />

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/neighborhood-300x214.png" alt="neighborhood" title="neighborhood" width="300" height="214" class="aligncenter size-medium wp-image-230" />

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/journal-300x216.png" alt="journal" title="journal" width="300" height="216" class="aligncenter size-medium wp-image-228" />

<img src="http://tutorius.org/blog/wp-content/uploads/2010/03/write-300x216.png" alt="write" title="write" width="300" height="216" class="aligncenter size-medium wp-image-232" />

The information presented to the user will be essentially composed of bubble messages pointing at screen elements. Progress through the tutorial will be accomplished by the user clicking a next button at the bottom of the screen. Once the tutorial is over, the user will be brought back to the Desktop screen where she will be able to resume interacting with the system normally.

The tutorial should be stored in the user home directory, alongside any activity data, as an XML file representing the execution states of the tutorial.

Translation of the tutorial should be made using the gettext convention by storing translations of the tutorial strings along side the XML file using the gettext schema (.po, .pot, .mo files).

The tutorial should be independent of the screen resolution.

On top of that, the tutorial should be designed to be robust against unscripted actions made by the user. It means that if the user clicks on any button while the tutorial is showing the different elements of the interface, the tutorial should never become out-of-sync with the state of the interface in a way that cannot be resolved by the user. The examples given previously simply rely on the user pressing the next button when she is ready to move on, therefore issues about the exact state of the interface should be avoided.

For the 0.90 release, the tutorial won't be user modifiable other than by modifying the XML format by hand, which won't be recommended.

== Benefit to Sugar ==
''What is the benefit to the platform? If this is a major capability update, what has changed? If this is a new feature, what capabilities does it bring? Why will Sugar become a better platform or project because of this feature?''

''Make sure to note here as well if this feature has been requested by a specific deployment, or if it has emerged from a bug report.''

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''

== How To Test ==
{{:{{PAGENAME}}/Testing}}
== User Experience ==
''If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice.''

== Dependencies ==
''What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, does your feature depend on completion of another feature owned by someone else or that you would need to coordinate, which might cause you to be unable to finish on time? Other upstream projects like Python?''

== Contingency Plan ==
''If you cannot complete your feature by the final development freeze, what is the backup plan? This might be as simple as "None necessary, revert to previous release behaviour." Or it might not. If your feature is not completed in time, we want to assure others that other parts of Sugar will not be in jeopardy.''

== Documentation ==
''Is there upstream documentation on this feature, or notes you have written yourself? Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''

== Release Notes ==
''The Sugar Release Notes inform end-users about what is new in the release. An Example is [[0.84/Notes]]. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the release team and shipped with the release.''

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-13T20:34:50Z

ErickLavoie: /* Current status */

Features/Introduction Tutorial

2010-03-13T20:33:57Z

ErickLavoie: /* Owner */

Features/Introduction Tutorial

2010-03-13T20:30:04Z

ErickLavoie:

Features/Introduction Tutorial

2010-03-13T20:20:52Z

ErickLavoie:

Features/Introduction Tutorial

2010-03-13T20:20:34Z

ErickLavoie:

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|Introduction Tutorial]]

</noinclude>

'''Comments and Explanations:'''

There are comments (in italic) providing guidance to fill out each section, see also the [[Features/Policy|Feature Policy Page]] for a more detailed explanation of the new-feature process. '''Copy the source to a ''new page'' named Features/''Your Feature Name'' before making changes! DO NOT EDIT THIS TEMPLATE.'''





== Summary ==
''A sentence or two summarizing what this feature is and what it will do. This information is used for the overall feature summary page for each release.''

== Owner ==
''This should link to your home wiki page so we know who you are''
* Name: [[User:AcountName| Your Name]]

''Include you email address that you can be reached should people want to contact you about helping with your feature, status is requested, or technical issues need to be resolved''
* Email: <your email address so we can contact you, invite you to meetings, etc.>

== Current status ==
* Targeted release: (SUGAR_VERSION)
* Last updated: (DATE)
* Percentage of completion: XX%

== Detailed Description ==
''Expand on the summary, if appropriate. A couple of sentences suffices to explain the goal, but the more details you can provide the better.''

== Benefit to Sugar ==
''What is the benefit to the platform? If this is a major capability update, what has changed? If this is a new feature, what capabilities does it bring? Why will Sugar become a better platform or project because of this feature?''

''Make sure to note here as well if this feature has been requested by a specific deployment, or if it has emerged from a bug report.''

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''

== How To Test ==
{{:{{PAGENAME}}/Testing}}
== User Experience ==
''If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice.''

== Dependencies ==
''What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, does your feature depend on completion of another feature owned by someone else or that you would need to coordinate, which might cause you to be unable to finish on time? Other upstream projects like Python?''

== Contingency Plan ==
''If you cannot complete your feature by the final development freeze, what is the backup plan? This might be as simple as "None necessary, revert to previous release behaviour." Or it might not. If your feature is not completed in time, we want to assure others that other parts of Sugar will not be in jeopardy.''

== Documentation ==
''Is there upstream documentation on this feature, or notes you have written yourself? Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''

== Release Notes ==
''The Sugar Release Notes inform end-users about what is new in the release. An Example is [[0.84/Notes]]. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the release team and shipped with the release.''

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Features/Introduction Tutorial

2010-03-12T04:34:46Z

ErickLavoie: Created page with '<noinclude>{{TOCright}} Category:Feature Page Incomplete <Feature Name> <!-- You can add categories to tie features back to real deployments/schools requ…'

<noinclude>{{TOCright}}
[[Category:Feature Page Incomplete]]
[[Category:Feature|<Feature Name>]]

</noinclude>

'''Comments and Explanations:'''

There are comments (in italic) providing guidance to fill out each section, see also the [[Features/Policy|Feature Policy Page]] for a more detailed explanation of the new-feature process. '''Copy the source to a ''new page'' named Features/''Your Feature Name'' before making changes! DO NOT EDIT THIS TEMPLATE.'''





== Summary ==
''A sentence or two summarizing what this feature is and what it will do. This information is used for the overall feature summary page for each release.''

== Owner ==
''This should link to your home wiki page so we know who you are''
* Name: [[User:AcountName| Your Name]]

''Include you email address that you can be reached should people want to contact you about helping with your feature, status is requested, or technical issues need to be resolved''
* Email: <your email address so we can contact you, invite you to meetings, etc.>

== Current status ==
* Targeted release: (SUGAR_VERSION)
* Last updated: (DATE)
* Percentage of completion: XX%

== Detailed Description ==
''Expand on the summary, if appropriate. A couple of sentences suffices to explain the goal, but the more details you can provide the better.''

== Benefit to Sugar ==
''What is the benefit to the platform? If this is a major capability update, what has changed? If this is a new feature, what capabilities does it bring? Why will Sugar become a better platform or project because of this feature?''

''Make sure to note here as well if this feature has been requested by a specific deployment, or if it has emerged from a bug report.''

== Scope ==
''What work do the developers have to accomplish to complete the feature in time for release? Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?''

==UI Design==
''Does the feature have a direct impact on the work flow, or does it need a UI? Link here mockups, or add detailed descriptions.''

== How To Test ==
{{:{{PAGENAME}}/Testing}}
== User Experience ==
''If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice.''

== Dependencies ==
''What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, does your feature depend on completion of another feature owned by someone else or that you would need to coordinate, which might cause you to be unable to finish on time? Other upstream projects like Python?''

== Contingency Plan ==
''If you cannot complete your feature by the final development freeze, what is the backup plan? This might be as simple as "None necessary, revert to previous release behaviour." Or it might not. If your feature is not completed in time, we want to assure others that other parts of Sugar will not be in jeopardy.''

== Documentation ==
''Is there upstream documentation on this feature, or notes you have written yourself? Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.''

== Release Notes ==
''The Sugar Release Notes inform end-users about what is new in the release. An Example is [[0.84/Notes]]. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the release team and shipped with the release.''

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]