Changes

Jump to navigation Jump to search

Activity Team/Getting Involved (view source)

Revision as of 08:56, 10 March 2010

2,306 bytes added ,  08:56, 10 March 2010
dev.sugarlabs.org -> bugs.sugarlabs.org
Line 1: Line 1:  
<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Activity Team}}</noinclude>{{TOCright}}
 
<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Activity Team}}</noinclude>{{TOCright}}
 +
 +
==Install Sugar==
 +
 +
The easiest way is installing sugar from [[Development_Team/Packaging|native packages]].
 +
 +
If your favourite GNU/Linux distribution doesn't provide sugar or contains out-of-dated packages(in most cases you don't need latest minor release(like 0.82.1, 0.84.1), the good practise is looking for the last major release(0.82, 0.84)) you could consider possibility to use [[Development_Team/Jhbuild|sugar-jhbuild]] - the system used by core developers to build sugar from last git sources.
 +
 +
As an activity developer in most cases you need only [[Taxonomy#Glucose:_The_base_Sugar_environment|glucose]] module(its included to ''sugar-glucose'' or ''sugar'' packages).
 +
 +
== If you want to create your own activity ==
 +
 +
What you need to do to create or share your activity.
 +
 +
==== Start coding ====
 +
 +
* '''Create''' an account on [http://git.sugarlabs.org git.sugarlabs.org] and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
 +
* '''Create a new project''' (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in '''category "activities"'''.
 +
* [[Activity_Team/Git_FAQ#How_do_I_create_a_new_project.3F|Initiate]] your project
 +
* You can copy/paste [http://git.sugarlabs.org/projects/hello-world Hello World] activity to get an example of usual files hierarchy.
 +
* Place your activity to ~/Activities/'''activity-name'''.activity directory.<br>To test your activity in sugar environment:
 +
** use ''sugar'' command to run sugar as a regular window manager
 +
** use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning.
 +
* Consult with [[Activity Team/Resources]] to get useful links, [[Development Team/Almanac]] could be a good start page
 +
* '''Start''' coding :)
 +
 +
==== Share your activity ====
 +
 +
If you want to share your activity for broad audience:
 +
 +
* Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to create component for your activity e.g. {{bug|788}}
 +
* Using ''setup.py'' from activity root directory, create .pot file
 +
* '''Add''' the ''pootle'' user as a committer (from the "add committer" link on the mainline page) on [http://git.sugarlabs.org git.sugarlabs.org]
 +
* Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to add your activity to [http://translate.sugarlabs.org/ pootle](sugar translation environment) e.g. {{bug|810}}
 +
* '''Upload a xo bundle'''(use ''setup.py'' to create bundle) to [http://activities.sugarlabs.org/ activities.sugarlabs.org].
 +
** Be sure to include a couple of screenshots of your activity in action.
 +
** [[Activity_Library/Glossary#Public_activity|Nominate]] your activity to the public
 +
* Create activity page ''wiki.sugarlabs.org/go/Activities/<activity-name>''<br>keep in mind that page on [http://activities.sugarlabs.org/ activities.sugarlabs.org] targeted to users and page on wiki targeted to more experienced users and developers
    
==Join the Activity Team==
 
==Join the Activity Team==
Line 8: Line 45:  
# Create a User page on wiki.sugarlabs.org if you have not already.
 
# Create a User page on wiki.sugarlabs.org if you have not already.
 
# Copy your SSH public key into your User page.
 
# Copy your SSH public key into your User page.
−
# Add a link to your User page to [[ActivityTeam/Contacts]].
+
# Add a link to your User page to [[Activity Team/Contacts]].
−
# Send an email introducing yourself to sugar-devel@lists.sugarlabs.org.
+
# [http://lists.sugarlabs.org/listinfo/sugar-devel Subscribe], and send an email introducing yourself to sugar-devel@lists.sugarlabs.org.
    
If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org.
 
If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org.
   −
==Quick Start==
+
==Help the Activity Team==
 +
 
 
If you'd rather just start coding '''right now''', it's easy to do!   
 
If you'd rather just start coding '''right now''', it's easy to do!   
   −
* Install sugar at first
+
* Check [[Activity Team/TODO]] for ideas to work on.  To start small, pick an Activity Feature Request.  If you'd rather work on something harder, try one of the High Impact Tasks.   
−
** The easiest way is installing sugar from [[Development_Team/Packaging|native packages]]
+
* If you haven't already set up Sugar, see [[Activity Team/Resources]].
−
** If your favourite GNU/Linux distribution doesn't provide sugar or contains out-of-dated packages(in most cases you don't need latest minor release(like 0.82.1, 0.84.1), the good practise is looking for the last major release(0.82, 0.84)) you could consider possibility to use [[Development_Team/Jhbuild|sugar-jhbuild]] - the system used by core developers to build sugar from last git sources.
  −
* Check [[ActivityTeam/TODO]] for ideas to work on.  To start small, pick an Activity Feature Request.  If you'd rather work on something harder, try one of the High Impact Tasks.   
  −
* If you haven't already set up Sugar, see [[ActivityTeam/Resources]].
   
* Clone the Git repository for the project you picked and register it with Sugar.
 
* Clone the Git repository for the project you picked and register it with Sugar.
 
<pre>
 
<pre>
Line 29: Line 64:  
</pre>
 
</pre>
 
* Hack on the source code.
 
* Hack on the source code.
−
* Test you code in sugar environment
  −
** use ''sugar'' command to run sugar as a regular window manager
  −
** use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning. 
   
* Create a patch file containing your changes.
 
* Create a patch file containing your changes.
 
<pre>
 
<pre>
Sascha silbe
344

edits

Retrieved from "https://wiki.sugarlabs.org/go/Special:MobileDiff/24297...49582"

Navigation menu