Initially

The first time you would like to translate a CKM archetype, please take the time to do the following.

• Translator for any archetype. Register yourself as CKM archetype translator:
  1. Select *Tools/Update my profile* from CKM's main menu.
  2. In the tab Availability as reviewer check the box I am available as a translator.
  3. Select the languages you are willing to translate.
• Translator for any/all archetypes owned by a project or incubator. As a translator for a team you can translate archetypes owned by this project or incubator.
  1. Use CKM to request to be added to a project or incubator: Go to the project or incubator you are interested in and select the Project members icon and then the Your requests tab. In this tab, under Request to join project/incubator select the role Translator and click the Request to join  button, OR
  2. Email the editor of the team and ask her/him to add you as a translator for the team.

          Once the editor of the team has approved your request, you can then checkout an archetype for translation.

Checkout the Archetype

• Right-click on an archetype and select Revise archetype/Checkout archetype from the context menu.
• In the new CKM tab click on the Check-out archetype button.

Once check-out is completed, the translation of the archetype can either be done using the Ocean Archetype Editor or any other tool for editing archetypes (Option 1) or it can be done directly in CKM (Option 2).

Start Your Translation

Option 1: Translate Archetypes using an External Editor

1. Download archetype to your local computer.
2. Translate the archetype using an external editor.
   • Instructions for translating with the Ocean Archetype Editor
3. Once completed you can upload the archetype back to CKM by:
   • Right-click on the archetype in the CKM left panel.
   • Select Revise archetype/Upload modified archetype and on the new CKM tab, select the archetype from your local file system and upload the archetype.
   • Changes you have made to the archetype are shown and you need to provide a log message to describe the revision made for this archetype.
   • You can also view your uploaded archetype by selecting View uploaded branch.
   • You can repeat this several times until you are satisfied that the translation is correct.
   • Once you are satisfied that the translation is correct (and you have e.g. checked this with other colleagues), please notify the editor of the archetype. The editor will then commit the archetype back to the trunk.

Note: Please take care not to change any other parts of the archetype. The editor may not be able to use your translation.

Option 2: Translate Archetypes Directly in CKM

Alternatively, CKM also supports translation of archetypes directly in CKM. That means that you do not have to download the archetype and open it in an external tool and once finished upload the archetype to CKM.

1. Select archetype and target language for translation.
   • Once the archetype has been checked out for your use on a "branch", you can start translating this archetype by right-clicking on an archetype in the left panel and selecting Translate archetype.
   • Select your Target language (the language you want to translate this archetype into) and click the Translate archetype button to start your translation. This button may also be labelled "Edit existing translation" if at least a part of the translation already exists for the selected language.
2. Start your translation
   • The complete tree of the archetype will appear and you can start your translation. Any item that has not been translated will appear in bold in the tree.
   • You can directly select an item to translate or you can use the Next button to walk through all items and translate them as required.
   • If you need a break, click on the Submit translation and continue later button to save your work. You can continue your work by following the steps above again.
   • Once you finished your translation, you can use the Submit Final Translation and Notify Editor button instead, which will also send an email to the editor(s) of the archetype, notifying them that you have completed the translation and it can be checked in again by the editor(s). The editor will also do any merging if required (if for example the trunk has moved on in the mean time).
   • You can ask others to review your translation or help with the translation. One way of doing this is to right-click on the archetype in the tree in the CKM left panel (after you have saved it), select Archetype History from the context menu and in the new CKM tab click on the "Details" button of YOUR BRANCH of the archetype and select Share with Colleague. This will email a direct link to your archetype branch to colleagues of yours. A official CKM translation review functionality has also been put into place to streamline the review of translations.