ASLO2: Difference between revisions

(2 intermediate revisions by the same user not shown)

Line 1:

'''New Page [[Features/New_ASLO]]'''

The aslo2 is a hypothetical revision of the aslo site that brings new features. This pages discusses them.

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

== Features ==

You can view it live here: http://www.aslo.cf/

== Current ASLO Feature Parity ==

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

* Stores every version of the activity

* Shows the user the latest compatible version

* Can search by title or description

* Users can comment and add stars

* Activities in categories

* i18n ui

* The update manager in the system settings

== New Features ==

=== For Users ===

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

* Nicer ui - just in my own opinion

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

* Localised search - users can search in their own language

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

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

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

=== For Developers ===

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

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

~~Added that~~

* 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

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

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

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

== Activity Categories ==

* ~~UI localized~~

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

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

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

* Activities have categories

~~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)?~~

* Games (game)

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

* Programming (programming)

* Internet (internet)

* ~~Users can add comments and stars~~

* Science (science)

~~Yep.~~

* Maths (maths)

* Geography (geography)

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

* Office (office)

~~etc~~

* Tools (tools)

~~Just did that.~~

* System (system)

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

Please tell me what you think about these.

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

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

~~Yep, got that~~.

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

* make easier publish a new version

* automatic publish of development versions with github hooks

Here it is, step by step:

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

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

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

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

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

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

* improve communication with the ~~developers?~~

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

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

6. BE HAPPY :)

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

== Implementation Details ==

Line 69:

Line 91:

* 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 100:

* 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 1: / Line 1: @@
+'''New Page [[Features/New_ASLO]]'''
 The aslo2 is a hypothetical revision of the aslo site that brings new features. This pages discusses them.
 You can find the code here: https://github.com/SAMdroid-apps/aslo/
-== Features ==
+You can view it live here: http://www.aslo.cf/
+== Current ASLO Feature Parity ==
+Here are the important things the current ASLO has that the new one has too:
+* Stores every version of the activity
+* Shows the user the latest compatible version
+* Can search by title or description
+* Users can comment and add stars
+* Activities in categories
+* i18n ui
+* The update manager in the system settings
+== New Features ==
+=== For Users ===
-Here is a rundown from the mailing list:
+* Nicer ui - just in my own opinion
+* No more reloads - the activities detail pages load almost instantly
+* Localised search - users can search in their own language
+* '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.........
+* '''Not yet implemented:''' Connect B.SL.O with the ASLO - Let people post bug reports is a really easy way
-    [We] need start with the features the actual ASLO have:
+=== For Developers ===
-    * Stores every version of a activity (.xo, release notes, screenshots).
+* Github integration - a webhook can be connected with github which can build and update the activities listing automatically (see the technical description below)
-        Added that
+* 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
+* No more references to firefox addons in random corners of the site :)
-    * Can search by text or activity description (English only)
-        Yep. The search is even done client side so it is (almost) instant.
+== Activity Categories ==
-    * UI localized
+The new ASLO adds a ''categories'' field in the activity.info. It is a space separated list of categories.
-        I have that feature, but no translations :)
+The current categories are (with their name for the activity.info):
-    * Activities have categories
-        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)?
+* Games (game)
-    Also maybe put the categories in a categories field in activity.info?
+* Programming (programming)
+* Internet (internet)
-    * Users can add comments and stars
+* Science (science)
-        Yep.
+* Maths (maths)
+* Geography (geography)
-    * Offer the last activity version available based on the user Sugar version (if use Browse activity)
+* Office (office)
-    etc
+* Tools (tools)
-        Just did that.
+* System (system)
-    [You] can add the new features we need:
+Please tell me what you think about these.
-    * support i18n (search in languages different than English)
+== Help Us --- Translate it! ==
-        Yep, got that.
+'''Warning, the strings are unstable - you should wait before you translate'''
-    * make easier publish a new version
-    * automatic publish of development versions with github hooks
+Here it is, step by step:
-        I think so. I've probably also made it a pain to not use github hooks :)
+. Make a copy of this file: https://github.com/SAMdroid-apps/aslo/blob/master/web/locales/dev/translation.json
-    * bugs reports? (will create bus in bugs.sugarlabs.org?)
+. Translate the values (the things on the right of the colons)
-        That is a good idea! Maybe let developers choose between that and github issues?
+. 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
-    * improve communication with the developers?
+. Send me a pull request (or an email)
-        Well the aslo2 has lost all references to firefox :)
+. BE HAPPY :)
-        Also I have replies in that comments which let developers or community members reply, and I should add email notifications.
 == Implementation Details ==
@@ Line 69: / Line 91: @@
 * 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 100: @@
 * 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.