ASLO2: Difference between revisions
Added a page about the ASLO2 idea |
No edit summary |
||
| (3 intermediate revisions by the same user not shown) | |||
| 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. | 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/ | You can find the code here: https://github.com/SAMdroid-apps/aslo/ | ||
== JSON Backend == | 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 === | |||
* 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 | |||
=== For Developers === | |||
* Github integration - a webhook can be connected with github which can build and update the activities listing automatically (see the technical description below) | |||
* 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 :) | |||
== Activity Categories == | |||
The new ASLO adds a ''categories'' field in the activity.info. It is a space separated list of categories. | |||
The current categories are (with their name for the activity.info): | |||
* 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 == | |||
=== JSON Backend === | |||
The data about the activities is stored in a json file. This json file is available via GitHub (currently https://github.com/SAMdroid-apps/sugar-activities). This is served with the correct content type here: http://aslo-bot-master.sugarlabs.org/data.json | The data about the activities is stored in a json file. This json file is available via GitHub (currently https://github.com/SAMdroid-apps/sugar-activities). This is served with the correct content type here: http://aslo-bot-master.sugarlabs.org/data.json | ||
== Activity Buildbots == | === Activity Buildbots === | ||
The aslo2 integrates a lot with GitHub. It offers a web hook for which the activity can be automatically built and listing data extracted. | The aslo2 integrates a lot with GitHub. It offers a web hook for which the activity can be automatically built and listing data extracted. | ||
| Line 25: | Line 91: | ||
* Authors - You need to do that manually | * Authors - You need to do that manually | ||
* Bundle - Automatically compiled by the robots | * Bundle - Automatically compiled by the robots | ||
* Categories - from the activity.info - a space seperated list under the name categories | |||
== Commenting == | == Commenting == | ||
| Line 33: | Line 100: | ||
* Replying to comments | * Replying to comments | ||
* 4 comment types: bug, question, idea and rating | * 4 comment types: bug, question, idea and rating | ||