Thanks for starting this discussion. Here's some of my thoughts.
localisation of an adapt course
When localising an adapt course, the work is mostly done on the course’s jsons.
Prior to Framework 2.0, there's not much in terms of localisation of the
course.json. Only a couple of button texts and extension labels here and there. The rest of the jsons "localisation" happenes anyway for the course content itself.
With Framework 2.0, we have added quite a bit "globals" in the
course.json to be localised and additional extension labels, e.g. the Bookmarking extension.
For my current workflow, I localised the
course.json in Simplified Chinese and saved it as a sublime text snippet. Whenever I need to develop a course in Chinese, I just replace the content of the course.json from the framework with my localised snippet.
It's very easy to use, quick and effective.
If you don't use snippet, having a localised
course.json file as a template and copy it over to the course directory when needed is not much of a hussle. You can find a simplified Chinese version here from my github page.
I think this makes a good start point of course localisation. It'd be great if there's an option in the adapt-cli tool that you can select from a list of languages then download a specific language version of the course.json file rathen than the default English version.
But I don’t think localisation should be stopped here. The next section is my own journey with Adapt and I will give my recommendations at the end.
My Adapt Journey
Since the release of the Authoring Tool, we’ve seen a lot more non-developer but course-designer type of users started to learn and use the tool, myself included.
My adapt experience route is like this:
Started with the Authoring tool -> Encounted Some Techniqal Problems -> Go to the Community Forum and project github page finding solutions -> Not Satisfied with the Authoring Tool (e.g. lack certain plugin support, not very friendly with theme development testing, etc) -> Start to use the Framework.
Environment Setup Stage
From my own experience and my observation, it is quite difficult to set up the environment (Framework and Builder) for a non-developer. For a typical eLearning course designer, without prior knowledge of the command-line, it is very intimidating to set up the environment with all the git, node, mongodb etc. set-ups.
This is reflected in the forum discussion. A lot of questions are related to installation problem. And environment setting up is usually the main cause of the problem.
Some people may have stopped at this stage and never have had the chance to try adapt.
Course Building / Using the Adapt Tool Stage
Once the environment is set up and running, the course designer started to use the tool to build courses.
Without much prior knowledge of the framework and some key concepts, e.g. ABC, plugins, extensions etc. It was quite a struggle for me to build a sample course containing just a few blocks. My first few attemps failed with some error message. It turned out that the problem is caused by empty components.
It was very frustrating.
Looking for solutions
Of course, the resources and solutions are out there, you just have to dig them up. Then I went out to the community site, the project github pages for solutions.
This involves quite a lot search and read, all in English.
Also I found the knowledge is quite dispersed, not very easy to quickly locate a solution for your problem. A solution may buried deep down in a thread.
By the way, I was very impressed with the depth of knowledge on this site and the project's github page, the helpfulness and friendliness people shown in this community site.
Turning to the Framework
I found it was not very easy to test theme development with the authoring tool. And some of the plugins I wanted to use were not yet supported in the authoring tool. Then I started to develop course in the framework and this involved more reading and study of diffrent plugins.
Do I think the Framework is more effective? Yes.
But I believe unless you're experienced in editing in source code, it is much effective to use the authoring tool, once you grasp the key adapt concepts, components and extensions, and know your way around the tool's user interface.
Here's some recommendations.
- A localised sample course to introduce the key concepts.
- A localised Getting Started tutorial with Trouble-shooting key points to describe solutions for diffrent situation and errors.
- Localise user interface and usage description of the Authoring tool.
- A (video) tutorial of how to use the authoring_tool.
Althoug the above are not all related to localisation, the objective is to build a better user experience nontheless, expecially for non-developers.