View source for Maintaining activity web information

{{draft}}

# Develop your activity (hereafter referred to as ''My Thingy'')
# Host it on sugarlabs.org, see http://git.sugarlabs.org
# Create a web page for it here on {{SERVERNAME}}
#* in [[:Category:Activities]]
#* with semantic information from 'Edit with form]'
#* if you like, with the attractive "OBX badges"
# Create a little fragment called "Activities/''My Thingy'' (latest)" for it and transclude this in [[Activities/All]] with <tt><nowiki>{{:Activities/</nowiki>''My&nbsp;Thingy'' (latest)}}</tt>

As you continue development of your activity you need to update the web pages in steps 3 and 4.  Additionally:
* Should it be invited to be a part of an [[Activity groups|Activity group]], the activity group's maintainer can transclude the same fragment in the appropriate pages such as [[Activities/G1G1/8.2]], [[Activities/G1G1]], etc.
* Once the latest version no longer works for a particular release or stream, create a separate fragment for that, such as "Activities/8.2/''My Thingy'' (8.2)" and the activity group's maintainer can transclude that fragment in the specific release's page (in this example [[Activities/G1G1/8.2]]).

This page describes the web page maintenance in more detail.

== Move it all to sugarlabs.org ?! ==
'''Maybe instead just a placeholder on wiki.laptop.org with just {{tl|Migrated to sl.o}} and a category?
 <nowiki> {{Migrated to sl.o | http://git.sugarlabs.org/projects/irc | http://addons.sugarlabs.org/en-US/sugar/addon/4029 }}
 [[Category:Activities]]</nowiki>
'''

== Your activity's web page ==
''Do not use '' [[Creating an activity]] and its buttons to create your page, alas they are out-of-date.   Instead, copy what you understand from an existing activity's page. ''TODO: Need to create an acceptable simple template''

; It should be in [[:Category:Activities]]
: Otherwise no one will find it!
; It must have semantic information in it.
: Pages in  [[:Category:Activities]] get an '[Edit with form]' tab button, you should click this and fill in information about your activity.  This will ensure your activity will show up in pages like [[Activity queries]].
* You can use the activity "OBX" (OLPC Box) templates such as {{tl|OBX_activity}} to display attractive badges for it, but this will mean more stuff you have to keep up to date.
* It can have screenshots, etc.

== Software update ==
The [[Software update]] [[Sugar Control Panel]] will consult a series of web pages to find the most recent version for the release the laptop is running, and will install or update to that version.
This requires that
# the right web pages exist
# the web pages have the information in the right machine-readable format4

=== Your own activity  ===

You can mention a URL to contact in its <tt>activity.info</tt> file, see [[Activity_bundles]].
That can be a fragment for it on the web site.

=== Activity groups ===

Laptops in the [[G1G1]] program (and possibly country [[deployments]]) are configured to install a set of activities known as an [[Activity group]].  

''Do not add your activity to a group, except perhaps [[Activities/Joyride]].''
The decision as to what activities and collections belong in a group is not yours to make!

=== Fragments for activities ===
Activities in the activity groups are set up as follows.
They all use the template {{tl|Activity-oneline}}, which creates the correct HTML for the [[Activity microformat]].

{|class=wikitable

! Name
! Description
! Sample
|-
| Activities/''My Thingy'' (latest)
| This is the latest version of your activity available.  It should match the primary information from '[Edit with form]' on your activity's web page.
| [[Activities/Etoys (latest)]]
|-
| Activities/''My Thingy'' (8.2)
| This is version of your activity that works with release [[8.2.0]].  If that version is identical to the latest, then you can make it a <tt>#REDIRECT</tt> page to the latest.  The moment your latest version no longer works with 8.2 you need to maintain this separately.
| [[Activities/Etoys (8.2)]]
|}

You don't need a fragment for earlier releases than [[8.2.0]] since they did not have the [[Software update]] feature.
You can present these earlier versions on your activity's web page.

== Other bits and pieces ==
Several activities seem to have a page "Activities/''My Thingy''" (with no version in parentheses).
This seems to be unused, and is often a redirect to an unused "Projects/''My Thingy''" using  {{tl|Activity-summary}} template (obsolete?!).
''TODO: '''KILL THESE''' ''

== Things to check ==
* The version and bundle URL listed in [[Activities/All]] should match the latest [[Property:Activity version]] and [[Property:Activity bundle]] on the activity's web page (set using '[Edit with form]').

=== If an activity is in an activity group ===
* The activities transcluded into [[Activities/G1G1]] should ''exactly match'' the set of activities with [[Property:Activity group]] set to Activities/G1G1 (set using'[Edit with form]').
Only a release or deployment manager can decide an activity is in an activity group such as G1G1.  if it is, then:
* The version and bundle URL listed in [[Activities/G1G1]] should match the latest [[Property:Activity version]] and [[Property:Activity bundle]] on the activity's web page (set using '[Edit with form]').
* The version and bundle URL listed in [[Activities/G1G1/8.2]] should either match that or be an earlier version.


== A better way ==
There's way too much update here!

See [[Semantic_MediaWiki#For activities]] and [[Semantic_MediaWiki/Activities]] for a better approach.
* The hard maintenance of [[Activities/All]] should be retired in favor of a [[Activity queries|query for all downloadable activities]].
* [Edit with form] should produce the [[Activity microformat]] directly on the activity page
* the [Add another] version button should either create NO properties at all, or create separate "'''earlier''' activity version/bundle/software release" properties so there's no ambiguity about what is the latest activity version/bundle URL/software release
** This could be a <nowiki><noinclude</nowiki> fragment.
* the OBX badges should fill in with semantic info if present
* still have to maintain "Activities/''My Thingy'' (8.2)" fragment separately, even though the info is in the activity's web page.

==Migrating activities to SugarLabs ==

Developers are moving many activities to SugarLabs infrastructure,
see [http://sugarlabs.org/go/ActivityTeam/How_to_migrate_from_OLPC How to migrate from OLPC]
and [http://sugarlabs.org/go/ActivityTeam/ActivityStatus Activity status].

However, as of February 2009 the sugarlabs wiki does not have [[Semantic MediaWiki]] extension nor does it host any of the [[Activity group]] URLs.
So activities in [[Activity groups]] probably still need to maintain web information on {{SERVERNAME}}.

After migrating to SugarLabs infrastructure, the elements you need to update are the URLs for XO bundles, source code, and localization.
* On the activities web page, click [Edit with form]:
** update the '''URL for the .xo bundle''' field that sets [[Property:Activity bundle]]
** update the '''Activity source (e.g., a git repo URL)''' field that sets [[Property:Source code]]
** update the '''Localization link''' field that sets [[Property:Localization URL]]
** remove or update the {{tl|OBX xobundle}} template that displays the .xo badge
** remove the {{tl|OBX source dev}} template that displays the .git badge &mdash; seems hardcoded to dev.laptop.org
** remove or update the {{tl|OBX pootle}} template that displays the OLPC pootle badge
* In activity lists such as [[Activities/All]] and/or fragments such as "Activities/''My Thingy'' (latest)":
** update the activity template fields <tt>activity_bundle</tt>, <tt>activity_source</tt>, and <tt>i18n</tt>


[[Category:Developers]]
[[Category:HowTo]]