Sugar on a Stick/Activity Criteria: Difference between revisions

(8 intermediate revisions by 3 users not shown)

Line 1:

<~~big~~>~~<big><big>'''''This is a draft discussion.''' It does not reflect policy (yet) - it is our attempt to define a clear policy for inclusion for the '''4th release''' of SoaS (October 2010, as per the~~ [~~http~~:~~//spins.fedoraproject.org Fedora Spin~~] ~~release cycle).''</big>~~</~~big~~>~~</big>~~

<noinclude>{{TOCright}}

[[Category:Sugar on a Stick]]

</noinclude>

== Introduction ==

This page ~~is for gathering~~ requirements for Activity inclusion on the default [[Sugar on a Stick]] image. ~~These are~~ the criteria we will be ~~using to begin discussion~~ on ~~Activity inclusion in v.4.0, due for~~ release ~~at the end of October 2010~~.

This page describes the requirements for Activity inclusion on the default [[Sugar on a Stick]] image. This is the criteria Activities will be evaluated against when they go through the [[Sugar on a Stick release process#Feature process]].

~~There is a~~ table of activities mapped against these criteria on the [[~~Talk:SoaS_Activity_Criteria~~|~~discussion~~ page]].

The table of activities mapped against these criteria can be found at the [[Criteria_Status|wiki page]].

== Proposed requirements ==

Line 122:

Line 123:

'''Rationale:''' Collaboration is one of the most interesting aspects of the Sugar platform and it really showcases what makes Sugar different.

'''Test:''' This only applies if the ~~activity~~ supports collaboration~~. Test to make sure that two SOAS can see~~ the ~~activity~~ that ~~is shared, join the activity, see the correct data during collaboration, and make sure~~ it ~~handles the originator leaving the activity gracefully.~~

'''Test:''' This only applies if the Activity supports collaboration; if the Activity explicitly states that it does ''not'' support collaboration, this test passes by default.

'''~~Instructions:~~'~~'' I am not sure what to put here~~, is this ~~instructions for doing the~~ test ~~or for fixing collaboration bugs?~~

~~=== Add your own idea here ===~~

~~Be sure to describe~~:

If the Activity does support collaboration (or doesn't say whether it does or not):

'''~~Rationale:'~~'' ~~Where does~~ this ~~requirement come from and why is it important~~?

* Make 2 SoaS thumbdrives and install the Activity being tested on both.

* Get 2 computers; boot an SoaS thumbdrive on each one. Ensure both computers are connected to the same Jabber server.

* Start the Activity on one of the sticks, and share it with Neighborhood. Ensure the other stick sees that shared Activity in Neighborhood.

* Have the 2nd stick join the 1st stick's Activity. Ensure you are able to do this.

* Have both sticks collaborate within the Activity (however it is designed to be played). Ensure you can see the right data during collaboration - in other words, does this ''seem'' like the right way for this particular activity to be multi-player?

* Have the 1st stick leave the Activity. Ensure that both sticks handle this (the originator leaving the activity) gracefully.

~~'''Test:''' how we can make sure that~~ the ~~requirement is met - what sort of testing needs to be done to verify~~ this?

If all of the above tests pass, the Activity meets this criteria for inclusion.

'''Instructions:''' ~~links to instructions~~ on how Activity ~~authors and maintainers can fulfill the requirement~~, if ~~possible.~~

'''Instructions:''' TODO: Information on how to code collaboration functionality into an Activity needs to be linked from here. Alternatively, if you don't ''think'' an Activity supports collaboration ''yet,'' you should (1) mark it as "Does not yet support collaboration" somewhere on its wiki page, and (2) file a ticket for it under that Activity's component so that developers can add that functionality later on.

~~[[Category:Sugar~~ on a ~~Stick]]~~

@@ Line 1: / Line 1: @@
-<big><big><big>'''''This is a draft discussion.''' It does not reflect policy (yet) - it is our attempt to define a clear policy for inclusion for the '''4th release''' of SoaS (October 2010, as per the [http://spins.fedoraproject.org Fedora Spin] release cycle).''</big></big></big>
+<noinclude>{{TOCright}}
+[[Category:Sugar on a Stick]]
+</noinclude>
 == Introduction ==
-This page is for gathering requirements for Activity inclusion on the default [[Sugar on a Stick]] image. These are the criteria we will be using to begin discussion on Activity inclusion in v.4.0, due for release at the end of October 2010.
+This page describes the requirements for Activity inclusion on the default [[Sugar on a Stick]] image. This is the criteria Activities will be evaluated against when they go through the [[Sugar on a Stick release process#Feature process]].
-There is a table of activities mapped against these criteria on the [[Talk:SoaS_Activity_Criteria|discussion page]].
+The table of activities mapped against these criteria can be found at the [[Criteria_Status|wiki page]].
 == Proposed requirements ==
@@ Line 122: / Line 123: @@
 '''Rationale:''' Collaboration is one of the most interesting aspects of the Sugar platform and it really showcases what makes Sugar different.
-'''Test:''' This only applies if the activity supports collaboration. Test to make sure that two SOAS can see the activity that is shared, join the activity, see the correct data during collaboration, and make sure it handles the originator leaving the activity gracefully.
+'''Test:''' This only applies if the Activity supports collaboration; if the Activity explicitly states that it does ''not'' support collaboration, this test passes by default.
-'''Instructions:''' I am not sure what to put here, is this instructions for doing the test or for fixing collaboration bugs?
-=== Add your own idea here ===
-Be sure to describe:
+If the Activity does support collaboration (or doesn't say whether it does or not):
-'''Rationale:''' Where does this requirement come from and why is it important?
+* Make 2 SoaS thumbdrives and install the Activity being tested on both.
+* Get 2 computers; boot an SoaS thumbdrive on each one. Ensure both computers are connected to the same Jabber server.
+* Start the Activity on one of the sticks, and share it with Neighborhood. Ensure the other stick sees that shared Activity in Neighborhood.
+* Have the 2nd stick join the 1st stick's Activity. Ensure you are able to do this.
+* Have both sticks collaborate within the Activity (however it is designed to be played). Ensure you can see the right data during collaboration - in other words, does this ''seem'' like the right way for this particular activity to be multi-player?
+* Have the 1st stick leave the Activity. Ensure that both sticks handle this (the originator leaving the activity) gracefully.
-'''Test:''' how we can make sure that the requirement is met - what sort of testing needs to be done to verify this?
+If all of the above tests pass, the Activity meets this criteria for inclusion.
-'''Instructions:''' links to instructions on how Activity authors and maintainers can fulfill the requirement, if possible.
+'''Instructions:''' TODO: Information on how to code collaboration functionality into an Activity needs to be linked from here. Alternatively, if you don't ''think'' an Activity supports collaboration ''yet,'' you should (1) mark it as "Does not yet support collaboration" somewhere on its wiki page, and (2) file a ticket for it under that Activity's component so that developers can add that functionality later on.
-[[Category:Sugar on a Stick]]