ASLO2: Difference between revisions

Line 3:

You can find the code here: https://github.com/SAMdroid-apps/aslo/

~~== Features ==~~

You can view it live here: http://128.199.197.37/

~~Here is a rundown from the mailing list:~~

== Current ASLO Feature Parity ==

~~[We] need start with~~ the ~~features~~ the ~~actual~~ ASLO ~~have~~:

Here are the important things the current ASLO has that the new one has too:

* Stores every version of a activity ~~(.xo, release notes, screenshots).~~

* Stores every version of the activity

~~Added that~~

* Shows the user the latest compatible version

* Can search by title or description

* Can search by ~~text~~ or ~~activity~~ description ~~(English only)~~

* Users can comment and add stars

~~Yep.~~ The search ~~is even done client side so~~ it is ~~(almost~~) ~~instant.~~

* Activities in categories

* i18n ui

* ~~UI localized~~

~~I have~~ that ~~feature~~, ~~but no translations~~ :)

'''Still ToDo'''

* ~~Activities have categories~~

* The update manager in the system settings

~~I will add that~~. I~~'m not~~ really ~~sure what categories~~ to ~~do, maybe these: http://jsfiddle.net/H5sAH/2/ (I tried~~ to ~~base it off~~ the ~~ASLO but the ASLO's categories IMHO are pretty confusing~~)?

~~Also maybe put the categories in~~ a categories field in activity.info?

== New Features ==

* Users can add comments and stars

=== For Users ===

~~Yep~~.

* Nicer ui - just in my own opinion

* ~~Offer the last activity version available based on the user Sugar version~~ (~~if use Browse activity~~)

* No more reloads - the activities detail pages load almost instantly

~~etc~~

* Localised search - users can search in their own language

~~Just did that.~~

* 'Instant' search - it is very fast :)

* A comment system that lets people to actually discuss activities - they can post ideas, questions, reviews and bug reports. Any user can then post a reply to the post and then somebody can reply to the reply.........

~~[You] can add the new features we need:~~

* '''Not yet implemented:''' Connect B.SL.O with the ASLO - Let people post bug reports is a really easy way

* ~~support i18n~~ (~~search in languages different than English~~)

=== For Developers ===

~~Yep, got that.~~

* Github integration - a webhook can be connected with github which can build and update the activities listing automatically (see the technical description below)

* ~~make easier publish a new version~~

* Communication with their users - they can talk over the comments system (in real time even). I really need to add email notifications so this can work better

* automatic publish of development versions with github hooks

* No more references to firefox addons in random corners of the site :)

I think so. I'~~ve probably also made~~ it ~~a pain to not use github hooks~~ :)

== Activity Categories ==

* bugs reports? (will create bus in bugs.sugarlabs.~~org?)~~

~~That is~~ a ~~good idea! Maybe let developers choose between that and~~ github ~~issues?~~

The new ASLO adds a ''categories'' field in the activity.info. It is a space separated list of categories.

* improve communication with the ~~developers?~~

The current categories are (with their name for the activity.info):

~~Well~~ the ~~aslo2 has lost all references to firefox :~~)

Also ~~I have replies~~ in ~~that comments which let developers~~ or ~~community members reply, and I should add~~ email ~~notifications~~.

* Games (game)

* Programming (programming)

* Internet (internet)

* Science (science)

* Maths (maths)

* Geography (geography)

* Office (office)

* Tools (tools)

* System (system)

Please tell me what you think about these.

== Help Us --- Translate it! ==

'''Warning, the strings are unstable - you should wait before you translate'''

Here it is, step by step:

1. Make a copy of this file: https://github.com/SAMdroid-apps/aslo/blob/master/web/locales/dev/translation.json

2. Translate the values (the things on the right of the colons)

3. Save the translated file in /web/locales/en_US/translation.json (replace en_US with your language)

4. Also save it in the general language folder (without the country code). eg: /web/locales/en/translation.json

5. Send me a pull request (or an email)

6. BE HAPPY :)

== Implementation Details ==

Line 69:

Line 92:

* Authors - You need to do that manually

* Bundle - Automatically compiled by the robots

* Categories - from the activity.info - a space seperated list under the name categories

== Commenting ==

Line 77:

Line 101:

* Replying to comments

* 4 comment types: bug, question, idea and rating

~~== Design / UX ==~~

~~[[User:SAMdroid|SAMdroid]] ([[User talk:SAMdroid|talk]]) I think it looks nicer. You compare: http://imgur.com/C4oxFtS~~

~~It is a html5 site with ajax, rather than just server side pages.~~

@@ Line 3: / Line 3: @@
 You can find the code here: https://github.com/SAMdroid-apps/aslo/
-== Features ==
+You can view it live here: http://128.199.197.37/
-Here is a rundown from the mailing list:
+== Current ASLO Feature Parity ==
-    [We] need start with the features the actual ASLO have:
+Here are the important things the current ASLO has that the new one has too:
-    * Stores every version of a activity (.xo, release notes, screenshots).
+* Stores every version of the activity
-        Added that
+* Shows the user the latest compatible version
+* Can search by title or description
-    * Can search by text or activity description (English only)
+* Users can comment and add stars
-        Yep. The search is even done client side so it is (almost) instant.
+* Activities in categories
+* i18n ui
-    * UI localized
-        I have that feature, but no translations :)
+'''Still ToDo'''
-    * Activities have categories
+* The update manager in the system settings
-        I will add that. I'm not really sure what categories to do, maybe these: http://jsfiddle.net/H5sAH/2/ (I tried to base it off the ASLO but the ASLO's categories IMHO are pretty confusing)?
-    Also maybe put the categories in a categories field in activity.info?
+== New Features ==
-    * Users can add comments and stars
+=== For Users ===
-        Yep.
+* Nicer ui - just in my own opinion
-    * Offer the last activity version available based on the user Sugar version (if use Browse activity)
+* No more reloads - the activities detail pages load almost instantly
-    etc
+* Localised search - users can search in their own language
-        Just did that.
+* 'Instant' search - it is very fast :)
+* A comment system that lets people to actually discuss activities - they can post ideas, questions, reviews and bug reports. Any user can then post a reply to the post and then somebody can reply to the reply.........
-    [You] can add the new features we need:
+* '''Not yet implemented:''' Connect B.SL.O with the ASLO - Let people post bug reports is a really easy way
-    * support i18n (search in languages different than English)
+=== For Developers ===
-        Yep, got that.
+* Github integration - a webhook can be connected with github which can build and update the activities listing automatically (see the technical description below)
-    * make easier publish a new version
+* Communication with their users - they can talk over the comments system (in real time even). I really need to add email notifications so this can work better
-    * automatic publish of development versions with github hooks
+* No more references to firefox addons in random corners of the site :)
-        I think so. I've probably also made it a pain to not use github hooks :)
+== Activity Categories ==
-    * bugs reports? (will create bus in bugs.sugarlabs.org?)
-        That is a good idea! Maybe let developers choose between that and github issues?
+The new ASLO adds a ''categories'' field in the activity.info. It is a space separated list of categories.
-    * improve communication with the developers?
+The current categories are (with their name for the activity.info):
-        Well the aslo2 has lost all references to firefox :)
-        Also I have replies in that comments which let developers or community members reply, and I should add email notifications.
+* Games (game)
+* Programming (programming)
+* Internet (internet)
+* Science (science)
+* Maths (maths)
+* Geography (geography)
+* Office (office)
+* Tools (tools)
+* System (system)
+Please tell me what you think about these.
+== Help Us --- Translate it! ==
+'''Warning, the strings are unstable - you should wait before you translate'''
+Here it is, step by step:
+. Make a copy of this file: https://github.com/SAMdroid-apps/aslo/blob/master/web/locales/dev/translation.json
+. Translate the values (the things on the right of the colons)
+. Save the translated file in /web/locales/en_US/translation.json (replace en_US with your language)
+. Also save it in the general language folder (without the country code). eg: /web/locales/en/translation.json
+. Send me a pull request (or an email)
+. BE HAPPY :)
 == Implementation Details ==
@@ Line 69: / Line 92: @@
 * Authors - You need to do that manually
 * Bundle - Automatically compiled by the robots
+* Categories - from the activity.info - a space seperated list under the name categories
 == Commenting ==
@@ Line 77: / Line 101: @@
 * Replying to comments
 * 4 comment types: bug, question, idea and rating
-== Design / UX ==
-[[User:SAMdroid|SAMdroid]] ([[User talk:SAMdroid|talk]]) I think it looks nicer. You compare: http://imgur.com/C4oxFtS
-It is a html5 site with ajax, rather than just server side pages.