Difference between revisions of "Baseline"
(→Using a Baseline to track previous text updates) |
|||
| Line 1: | Line 1: | ||
== Baseline Overview == |
== Baseline Overview == |
||
| − | After |
+ | After a Localyzer project is created, but before the first prep kit, a baseline is created that will populate the database with the current state of the project. If any files are changed before the prep kit, then those changes can be tracked. |
For Example: |
For Example: |
||
| Line 13: | Line 13: | ||
If the baseline was created with the original string, then the prep kit will know that the string has changed and send the new value to be translated. |
If the baseline was created with the original string, then the prep kit will know that the string has changed and send the new value to be translated. |
||
| − | == When do |
+ | == When do Baselining occurs? == |
| − | When |
+ | When a Localyzer project is created, it is '''not''' baselined. This allows users to make changes and fixes to the project. Once the configuration looks right, using the Localyzer Report page or the Validation button in Edit, click the Create a baseline. At this point, changes to existing files will be tracked. Some Localyzer project configuration cannot be changed. |
| − | Baselines are |
+ | Baselines are also created whenever a Prep Kit is sent out, automatically. |
| − | Please note that when the first baseline is created, |
+ | Please note that when the first baseline is created, Localyzer will make certain assumptions about the resource files from it. It is important to ensure that the Localyzer configuration is correct before creating your first baseline. Hence the 'validation' button when editing or creating a project. |
| − | == |
+ | == The 'Create Baseline' button == |
| + | Starting with 2.3, the Create Baseline button only appears when baselining may be necessary. Before clicking that button, please make sure that the configuration is done correctly. |
||
| − | If onboarding a new project to LRM with a previous translation history, you may wish to catch textual updates prior to onboarding time. |
||
| − | |||
| − | <b>Note:</b> This is an advanced use case recommended for experienced users. The following instructions assume you are already familiar with the system. |
||
| − | |||
| − | # Find a time in your version control history prior to the textual updates. Checkout the source code from this point. If appropriate, apply any transforms to the resource files (see /var/lib/jenkins/lingoport/transforms/<your transform>/). |
||
| − | # Create the LRM project. |
||
| − | # Verify that the LRM project is correctly configured by viewing the Lingoport Dashboard Resource Manager information. Confirm that all of the correct files tracked (hover over Next Prep Kit Content), and that LRM is not tracking any extraneous files. Check the Dashboard for the correct locales. |
||
| − | # Run the baseline with the following command: <code>java -jar ~jenkins/lingoport/lrm-server-<version>/lrm-cli.jar --create-baseline --group-name <your group> --project-name <your project></code> |
||
| − | # Return the project to the latest state of the source per source control. To see what changes were picked up, you may then optionally create a similar test project for the same source without the baseline and compare the result. |
||
Latest revision as of 18:44, 27 January 2025
Baseline Overview
After a Localyzer project is created, but before the first prep kit, a baseline is created that will populate the database with the current state of the project. If any files are changed before the prep kit, then those changes can be tracked.
For Example:
greeting="Hello!"
Might be updated to:
greeting="Hello! Welcome to ACME Supplies."
If the baseline was created with the original string, then the prep kit will know that the string has changed and send the new value to be translated.
When do Baselining occurs?
When a Localyzer project is created, it is not baselined. This allows users to make changes and fixes to the project. Once the configuration looks right, using the Localyzer Report page or the Validation button in Edit, click the Create a baseline. At this point, changes to existing files will be tracked. Some Localyzer project configuration cannot be changed.
Baselines are also created whenever a Prep Kit is sent out, automatically.
Please note that when the first baseline is created, Localyzer will make certain assumptions about the resource files from it. It is important to ensure that the Localyzer configuration is correct before creating your first baseline. Hence the 'validation' button when editing or creating a project.
The 'Create Baseline' button
Starting with 2.3, the Create Baseline button only appears when baselining may be necessary. Before clicking that button, please make sure that the configuration is done correctly.
