Sugar Labs

Activity Library/Authors: Difference between revisions

← Older editNewer edit →
No edit summary
Line 3: Line 3:


== Contributing your Activity ==
== Contributing your Activity ==
=== Developing your activity ===
=== Developing your activity ===
For a guide on developing your own activity, please visit the [[Activity Team]].
For a guide on developing your own activity, please visit the [[Activity Team]].


=== Preparing your Activity for Review ===
=== Preparing your Activity ===
* Have a public system for reporting and managing bugs in your activity. This is an invaluable resource for us when we are reviewing your activity as it gives us information on any problems in your activity.  We recommend using http://dev.sugarlabs.org .
* Have a public system for reporting and managing bugs in your activity. This is an invaluable resource for us when we are reviewing your activity as it gives us information on any problems in your activity.  We recommend using http://dev.sugarlabs.org .
* If possible, conduct a beta release cycle from your website every time you want to release a new version of your activity. Allow your current users to be involved, but be sure to warn them that the activity is in beta ;) Conducting a beta cycle will ensure your activity has less bugs and is of a higher quality when you release it and/or release new versions.
* If possible, conduct a beta release cycle from your website every time you want to release a new version of your activity. Allow your current users to be involved, but be sure to warn them that the activity is in beta ;) Conducting a beta cycle will ensure your activity has less bugs and is of a higher quality when you release it and/or release new versions.
Line 14: Line 15:
* Only declare compatibility with Sugar versions and operating systems that you have tested with.
* Only declare compatibility with Sugar versions and operating systems that you have tested with.
* Comply with [http://activities.sugarlabs.org/pages/policy Activity Policy]. They're only drafts at the moment, but we still enforce them.
* Comply with [http://activities.sugarlabs.org/pages/policy Activity Policy]. They're only drafts at the moment, but we still enforce them.
* Do not use Library Editors as beta testers and bug finders. This is not the purpose of editors. Please test the activity extensively before nominating to the public.
* But you are free(and really welcome) to [[Activity_Library/Glossary#Submited_activity|Submit]] and [[Activity_Library/Glossary#Completed_activity|Complete]] your activity to let users test it for you.


=== Uploading your activity ===
=== Submiting your activity ===
* Once you have developed your activity(alpha and beta versions are welcome), create a [http://activities.sugarlabs.org/en-US/sugar/users/register Library Account].
* Once you have developed your activity(alpha and beta versions are welcome), create a [http://activities.sugarlabs.org/en-US/sugar/users/register Library Account].
* [[Activity_Library/Glossary#Submited_activity|Submit]] your Activity to the [http://activities.org/en-US/sugar/developers Activity Library].
* [[Activity_Library/Glossary#Submited_activity|Submit]] your Activity to the [http://activities.org/en-US/sugar/developers Activity Library].
* [[Activity_Library/Glossary#Completed_activity|Complete]] it
* [[Activity_Library/Glossary#Completed_activity|Complete]] it.
* If your activity is in alpha or beta stage and you want other users test it for you, email to [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@] mailing list with tag [ANNOUNCE] in subject field.
* If your activity is in alpha or beta stage and you want other users test/review it for you, email to [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel@] mailing list with tag [ANNOUNCE] in subject field.
* If your activity is ready to be public, [[Activity_Library/Glossary#Nominated_activity|Nominate]] it.


== Activity Libary Developer Pages ==
=== Making you activity Public ===
=== Welcome Page ===
* If your activity is ready to be public, [[Activity_Library/Glossary#Nominated_activity|Nominate]] it. After that, your activity will pushed to review queue for Library Editors.
Also known as the Developers Control Panel (or Developers CP), when you enter /developers/ you are prompted to login or create an account.
* Do not use Library Editors as beta testers and bug finders. This is not the purpose of editors. Please test the activity extensively before nominating to the public.
 
=== Main Page ===
Once you've logged in, you're presented with a brief overview of the activities you've submitted and links to submit more.
 
=== User Profile ===
Each user is able to edit their own profile.  Here you specify your name, email, and personal website. By default, your email address is not listed on the end-user website. Administrators are also presented with the ability to manage the permissions level of the user. 
 
A user can be designated as an Administrator, Editor (aka Moderator) or User (aka Developer).


=== User Manager ===
An administrator has a list of all users and their permissions.  From this screen mass updates are available.  There is also a link for creating a new user.
=== Listings ===
Available to administrators only, a list of every item can be shown.  On the sidebar are links to the Activities List.  This shows the name, description, and date last updated.  The name is a link to edit each item.
== Developer Tasks==
=== Reviewing procedure ===
Each submission must be approved by an Editor or Administrator before it is listed on the site. Whether approved or denied, an email is sent to the authors.  A comment is required if denied.  If approved, the activity is moved to a directory so that it can be replicated across the sugarlabs.org mirrors.
Each submission must be approved by an Editor or Administrator before it is listed on the site. Whether approved or denied, an email is sent to the authors.  A comment is required if denied.  If approved, the activity is moved to a directory so that it can be replicated across the sugarlabs.org mirrors.


Line 57: Line 40:
If you have questions about the procedure, you could join #sugar on irc.freenode.net. Information about how to get your activity reviewed faster can be found at: [[#How_to_Get_Your_Activity_Reviewed_Faster]].
If you have questions about the procedure, you could join #sugar on irc.freenode.net. Information about how to get your activity reviewed faster can be found at: [[#How_to_Get_Your_Activity_Reviewed_Faster]].


=== Comment Moderation ===
== Activity Libary Developer Pages ==


=== Application Manager ===
=== Welcome Page ===
Also known as the Developers Control Panel (or Developers CP), when you enter /developers/ you are prompted to login or create an account.


=== Category Manager ===
=== Main Page ===
Once you've logged in, you're presented with a brief overview of the activities you've submitted and links to submit more.


=== Creating an Account ===
=== User Profile ===
To create an account, you must supply a username and password.  A confirmation email is sent to your account.  A row is inserted into the userprofile table.
Each user is able to edit their own profile.  Here you specify your name, email, and personal website.  By default, your email address is not listed on the end-user website.  Administrators are also presented with the ability to manage the permissions level of the user.


=== Uploading an Item ===
A user can be designated as an Administrator, Editor (aka Moderator) or User (aka Developer).
You begin the process by browsing your hard drive and selecting the activity.  This file is then uploaded to a temp directory.  It will remain there until it is either approved or denied.


=== Managing an Existing Activity ===
=== User Manager ===
Managing an activity is split between several pages.  It begins with the item-overview.  This shows a summary of all versions.  From here you can go to a page to edit the common information (name, description, authors), a page to edit a version (minVer, maxVer, OS supported, release notes), a page to review feedback, and a page to add preview images.
An administrator has a list of all users and their permissions.  From this screen mass updates are available.  There is also a link for creating a new user.


== Uploading an Activity ==
=== Listings ===
* Click "Add New Activity..."
Available to administrators only, a list of every item can be shown. On the sidebar are links to the Activities List. This shows the name, description, and date last updated. The name is a link to edit each item.
* Upload the .xo file


At this point, the process varies slightly depending on whether you are an administrator or developer.


=== As an Administrator ===
* If the author field defaults to you and you know it is an existing item on the DB, STOP.  It means that something has changed


[[Category:Activity Library]]
[[Category:Activity Library]]
Retrieved from "https://wiki.sugarlabs.org/go/Activity_Library/Authors"