Jump to content

Sugar Network/1.0/Todo: Difference between revisions

From Sugar Labs
Line 8: Line 8:
* Software developers.
* Software developers.


== Workflows for involved people ==
== Workflows for involved categories of people ==


=== All Users ===
=== All Users ===
* To initiate a discussion, a user:
** chooses a context in the Browser
** can create a new Question by typing a title and some content and it will be findable in the Browser
** can create a new Idea by typing a title and some content and it will be findable in the Browser
** can create a new Problem by typing a title and some content and it will be findable in the Browser
** can type a new Review and it should be visible with other reviews in the Context
** can share an Artifact and it will be visible in the list of Artifacts


* To reply in a discussion, a user:
# User registration.
** must choose a resource from the Browser or the Context View
#: To do:
** can provide Solutions for Questions
#:* on XO #1, open Users list in the Browser and make sure you don't see XO #2's user;
** can provide Solutions for Ideas
#:* start XO #2 and open the Browser.
** can provide Solutions for Problems
#: Expected results:
** these Solutions will be viewable in the respective view
#:* on XO #1, open Users list in the Browser and make sure you see XO #2's user.
<!---->
# Create a new Context.
#: To do:
#:* click Upload button in the Browser;
#:* in popped up Journal objects chooser, select a .xo(l) bundle for Activity or Content Library that was not yet uploaded to the Network.
#: Expected results:
#:* new Context will be created and accessible in Contexts full list;
#:* new Context will be accessible via Browser's search bar after some timeout;
#:* if uploaded bundle has an inappropriate license, Browser should complain.
<!---->
# Update Version for the existing Context.
#: To do:
#:* click Upload button in the Browser;
#:* in popped up Journal objects chooser, select a .xo(l) bundle with newer version.
#: Expected results:
#:* find the Context you uploaded new Version for;
#:* make sure that version is exactly what was uploaded recently.
#:* if uploaded bundle has an inappropriate license, Browser should complain.
<!---->
# Launch a Context.
#: To do:
#:* find the Context to activate;
#:* click the Context's preview or Launch button.
#: Expected results:
#:* if Context is an Activity, it should be launched with;
#:* if Context is a Content bundle, Browse Activity should be launched with the content of chosen bundle.
<!---->
# Initiate a discussion.
#: To do:
#:* chooses a Context in the Browser;
#:* click button to create a new Question|Idea|Problem|Review and type the description.
#: Expected results:
#:* new Question|Idea|Problem|Review should appear at the bottom of the Context page;
#:* new Question|Idea|Problem|Review should be findable from the Browser's search bar after some timeout.
<!---->
# Create a Solution for Question|Idea|Problem.
#: To do:
#:* Find a Question|Idea|Problem using Browser's search bar or selecting it from the Context;
#:* click a button to create new Solution and type its description.
#: Expected results:
#:* new Solution should appear at the bottom of the Question|Idea|Problem page;
#:* new Solution should be findable from the Browser's search bar after some timeout.
<!---->
# Share a Sugar Activity object, an Artifact.
#: To do:
#:* find the Context to share object of;
#:* click the button and select the appropriate Journal object;
#: Expected results:
#:* new Artifact should appear at the bottom of the Artifacts page;
#:* new Artifact should be findable from the Browser's search bar after some timeout.
<!---->
# Restore an Artifact.
#: To do:
#:* find an Context to restore Artifact of;
#:* find an Artifact to restore;
#:* click the Artifact preview;
#: Expected results:
#:* the chosen Context Activity should be launched with chosen Artifact.
<!---->
# Comment an object.
#: To do:
#:* find a Question|Idea|Problem|Solution|Review|Artifact in the Browser;
#:* click the button to create new Comment and type its description.
#: Expected results:
#:* new Comment should appear at the bottom of selected Sugar Network object;
#:* new Comment should be findable from the Browser's search bar after some timeout.
<!---->
# Vote/unvote for an object.
#: To do:
#:* find a Question|Idea|Problem|Solution|Review|Artifact|Context in the Browser;
#:* click the star button.
#: Expected results:
#:* star for chosen object should be inverted after re-finding the same object;
#:* the rating of chosen object should be increased/decreased by one.
<!---->
# Change the description of Context|Question|Idea|Problem|Review|Solution|Artifact.
#: To do:
#:* find an object to change its description;
#:* click Edit button and change the description;
#:* click Apply button
#: Expected results:
#:* object's description should be changed even after re-finding.
#:* object should be findable, using newly typed description, from the Browser's search bar after some timeout.
<!---->
# Change the existing Artifact.
#: To do:
#:* find an Artifact to change;
#:* click the button and select the appropriate Journal object;
#: Expected results:
#:* existing Artifact's preview should be changed;
#:* clicking on Artifact will restore new Activity object.
<!---->
# Going offline.
#: To do:
#:* being connected to school server or Internet;
#:* find the Context that should be accessible offline;
#:* pin it to make the Context accessible offline.
#: Expected results:
#:* make sure you are not connected to the server anymore;
#:* in the Browser, you should see only Contexts you pinned being connected;
#:* all pinned Contexts should be launchable;
#:* it should be possible to create new Question|Idea|Problem|Review|Artifact|Comment associated with pinned Contexts;
#:* it should be possible to update Version for pinned Contexts;
#:* it should be possible to create new Contexts by uploading bundles.
<!---->
# Going online.
#: To do:
#:* follow the ''Going online'' workflow and make as many as possible changes;
#: Expected results:
#:* make sure are connected to the server;
#:* make sure that other people see all changes you made being offline.


* To comment a discussion, a user:
=== Chaski ===
** can create Comments for Questions
** can create Comments for Ideas
** can create Comments for Problems
** can create Comments for Reviews


* all users can upload bundles for Activities or Content Libraries and they will be added to the appropriate Context or a new one will be created
* Chaskis can create a USB stick that will syncronize the
* all users can mark a Context to be used offline
 
* Chaskis can create a USB stick that will syncronize the  


== Proof the workflows with statistics ==
== Proof the workflows with statistics ==

Revision as of 20:16, 28 January 2012

Involved categories of people

  • Students,
  • School teachers,
  • Educators to work with teachers,
  • Network messengers (Chaskis) who will relay updates
  • Technical supporters who provide technical support for end users and work with software developers,
  • Software developers.

Workflows for involved categories of people

All Users

  1. User registration.
    To do:
    • on XO #1, open Users list in the Browser and make sure you don't see XO #2's user;
    • start XO #2 and open the Browser.
    Expected results:
    • on XO #1, open Users list in the Browser and make sure you see XO #2's user.
  2. Create a new Context.
    To do:
    • click Upload button in the Browser;
    • in popped up Journal objects chooser, select a .xo(l) bundle for Activity or Content Library that was not yet uploaded to the Network.
    Expected results:
    • new Context will be created and accessible in Contexts full list;
    • new Context will be accessible via Browser's search bar after some timeout;
    • if uploaded bundle has an inappropriate license, Browser should complain.
  3. Update Version for the existing Context.
    To do:
    • click Upload button in the Browser;
    • in popped up Journal objects chooser, select a .xo(l) bundle with newer version.
    Expected results:
    • find the Context you uploaded new Version for;
    • make sure that version is exactly what was uploaded recently.
    • if uploaded bundle has an inappropriate license, Browser should complain.
  4. Launch a Context.
    To do:
    • find the Context to activate;
    • click the Context's preview or Launch button.
    Expected results:
    • if Context is an Activity, it should be launched with;
    • if Context is a Content bundle, Browse Activity should be launched with the content of chosen bundle.
  5. Initiate a discussion.
    To do:
    • chooses a Context in the Browser;
    • click button to create a new Question|Idea|Problem|Review and type the description.
    Expected results:
    • new Question|Idea|Problem|Review should appear at the bottom of the Context page;
    • new Question|Idea|Problem|Review should be findable from the Browser's search bar after some timeout.
  6. Create a Solution for Question|Idea|Problem.
    To do:
    • Find a Question|Idea|Problem using Browser's search bar or selecting it from the Context;
    • click a button to create new Solution and type its description.
    Expected results:
    • new Solution should appear at the bottom of the Question|Idea|Problem page;
    • new Solution should be findable from the Browser's search bar after some timeout.
  7. Share a Sugar Activity object, an Artifact.
    To do:
    • find the Context to share object of;
    • click the button and select the appropriate Journal object;
    Expected results:
    • new Artifact should appear at the bottom of the Artifacts page;
    • new Artifact should be findable from the Browser's search bar after some timeout.
  8. Restore an Artifact.
    To do:
    • find an Context to restore Artifact of;
    • find an Artifact to restore;
    • click the Artifact preview;
    Expected results:
    • the chosen Context Activity should be launched with chosen Artifact.
  9. Comment an object.
    To do:
    • find a Question|Idea|Problem|Solution|Review|Artifact in the Browser;
    • click the button to create new Comment and type its description.
    Expected results:
    • new Comment should appear at the bottom of selected Sugar Network object;
    • new Comment should be findable from the Browser's search bar after some timeout.
  10. Vote/unvote for an object.
    To do:
    • find a Question|Idea|Problem|Solution|Review|Artifact|Context in the Browser;
    • click the star button.
    Expected results:
    • star for chosen object should be inverted after re-finding the same object;
    • the rating of chosen object should be increased/decreased by one.
  11. Change the description of Context|Question|Idea|Problem|Review|Solution|Artifact.
    To do:
    • find an object to change its description;
    • click Edit button and change the description;
    • click Apply button
    Expected results:
    • object's description should be changed even after re-finding.
    • object should be findable, using newly typed description, from the Browser's search bar after some timeout.
  12. Change the existing Artifact.
    To do:
    • find an Artifact to change;
    • click the button and select the appropriate Journal object;
    Expected results:
    • existing Artifact's preview should be changed;
    • clicking on Artifact will restore new Activity object.
  13. Going offline.
    To do:
    • being connected to school server or Internet;
    • find the Context that should be accessible offline;
    • pin it to make the Context accessible offline.
    Expected results:
    • make sure you are not connected to the server anymore;
    • in the Browser, you should see only Contexts you pinned being connected;
    • all pinned Contexts should be launchable;
    • it should be possible to create new Question|Idea|Problem|Review|Artifact|Comment associated with pinned Contexts;
    • it should be possible to update Version for pinned Contexts;
    • it should be possible to create new Contexts by uploading bundles.
  14. Going online.
    To do:
    • follow the Going online workflow and make as many as possible changes;
    Expected results:
    • make sure are connected to the server;
    • make sure that other people see all changes you made being offline.

Chaski

  • Chaskis can create a USB stick that will syncronize the

Proof the workflows with statistics

Inventory of technical issues outside Client and Server

  • How will students register with a teacher
  • How will teachers turn their laptop into servers
  • What are the constraints of the syncronization mechanism
  • Patch to Journal for sharing in SN

Questions for expert

  • Should students and teachers be clearly separated in the GUI?
  • Should teachers track what their students do within the Network?
  • Should teachers moderate what their students do within the Network?
  • What kind of users' statistics will be useful for educators/researchers?
    See the current implementation of Australian request. The collected data are being stored in RRD format and might be represented in graphics.