Activity Team/Getting Involved: Difference between revisions

(17 intermediate revisions by 5 users not shown)

Line 9:

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).

~~Place~~ your activity ~~to ~/Activities/'''activity-name'''.activity directory.~~

== If you want to create your own activity ==

To test your activity in sugar environment:

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==

Line 22:

Line 45:

# Create a User page on wiki.sugarlabs.org if you have not already.

# 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.

==~~Quick Start~~==

==Help the Activity Team==

If you'd rather just start coding '''right now''', it's easy to do!

* 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.

* 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.

* If you haven't already set up Sugar, see [[~~ActivityTeam~~/Resources]].

* If you haven't already set up Sugar, see [[Activity Team/Resources]].

* Clone the Git repository for the project you picked and register it with Sugar.

<pre>

@@ Line 9: / Line 9: @@
 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).
-Place your activity to ~/Activities/'''activity-name'''.activity directory.
+== If you want to create your own activity ==
-To test your activity in sugar environment:
+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==
@@ Line 22: / Line 45: @@
 # Create a User page on wiki.sugarlabs.org if you have not already.
 # 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.
-==Quick Start==
+==Help the Activity Team==
 If you'd rather just start coding '''right now''', it's easy to do!
-* 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.
+* 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.
-* If you haven't already set up Sugar, see [[ActivityTeam/Resources]].
+* If you haven't already set up Sugar, see [[Activity Team/Resources]].
 * Clone the Git repository for the project you picked and register it with Sugar.
 <pre>