# \[Bug\]\[Documentation\] Translation: "main" is not default, but "release/ulmo.1"
**URL:** https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770
**Category:** Site Operators
**Created:** [April 10, 2026, 8:38am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770 "2026-04-10T08:38:41Z")
**Posts on this page:** 8
**Page:** 1
### Author:  [@AmbroiseRabier](https://discuss.openedx.org/u/AmbroiseRabier)
#### Post date: [April 10, 2026, 8:38am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/1 "2026-04-10T08:38:41Z")
From [Configuration and customisation — Tutor documentation](https://docs.tutor.edly.io/configuration.html#getting-and-customizing-translations)
> `ATLAS_REVISION` (default: `"main"` for Tutor Main, or `"{{ OPENEDX_COMMON_VERSION }}"` if a named release is used)
But it was by default `ulmo.1` on my instance. **So either the doc is wrong, or the code is wrong, which I don’t know.** (PS: In case anyone read this too fast, I do not need help for translations)
* * *
### Extra information
#### Context
I was looking to fix french translations, and while investigating, I saw that the repository [openedx-translations/translations at main · openedx/openedx-translations · GitHub](https://github.com/openedx/openedx-translations/tree/main/translations) already contained the proper french translation for some stuff, but my instance didn’t.
#### Issue
Default translations I had on my Ulmo instance, is base on git branch `release/ulmo.1`, which is a tag. Simple diagnostic:
```sh
grep -RIn ATLAS "$(tutor config printroot)/env"
/home/user/.local/share/tutor/env/plugins/mfe/build/mfe/Dockerfile:50:RUN make OPENEDX_ATLAS_PULL=true ATLAS_OPTIONS="--repository=openedx/openedx-translations --revision=release/ulmo.1 " pull_translations
```
#### Fix
For anyone having the issue, the fix is simple, set `ATLAS_REVISION: main` in `config.yml`. And rebuild affected docker images (mfe, …).
#### Others
I investigated this around and after 16 March from my notes, and I don’t remember exactly when I created this instance of Open edX, but it is no older than start of February.
PS: Don’t really know what tags I should put.
---
### Author:  [@AmbroiseRabier](https://discuss.openedx.org/u/AmbroiseRabier)
#### Post date: [April 10, 2026, 8:58am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/2 "2026-04-10T08:58:03Z")
Oh well, amusing how writing help see see things more clearly:
The documentation actually state it correctly `ATLAS_REVISION (default: "main" for Tutor Main, or "{{ OPENEDX_COMMON_VERSION }}" if a named release is used)`
`"{{ OPENEDX_COMMON_VERSION }}"` must be `release/ulmo.1` then ?
I don’t know where that variable is set:
```sh
# Both returns nothing
grep -RIn OPENEDX_COMMON_VERSION ~/.local/share/tutor/env/
grep -RIn OPENEDX_COMMON_VERSION ~/.local/share/tutor/config.yml
```
I also installed `tutor[full]`, latest version, simply following the tutorial, although the version is fixed with a lock file in my repository.
* * *
In conclusion, the simplest thing that could be done, is changing the documentation sentence by something like:
> ATLAS\_REVISION (default: “{{ OPENEDX\_COMMON\_VERSION }}”, check [Configuration and customisation — Tutor documentation](https://docs.tutor.edly.io/configuration.html#open-edx-customisation))
As the link contains the following doc:
> `OPENEDX_COMMON_VERSION` (default: `"release/ulmo.2"`, or `master` in [Tutor Main](https://docs.tutor.edly.io/developing/main.html#main))
---
### Author:  [@joel.edwards](https://discuss.openedx.org/u/joel.edwards)
#### Post date: [April 10, 2026, 10:44am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/3 "2026-04-10T10:44:48Z")
> [@AmbroiseRabier](#):
>
> I don’t know where that variable is set
`OPENEDX_COMMON_VERSION` would be set by the version of Tutor that you are using, for example [21.0.1](https://github.com/overhangio/tutor/blob/5dba841dc3de4d7f8a3354e9f0c7f40c9cc2c6d9/tutor/templates/config/defaults.yml#L64) would be `release/ulmo.1` or similarly [21.0.3](https://github.com/overhangio/tutor/blob/b7ad5df4f9478c36bb2d418c9f64c26bd2dd40f1/tutor/templates/config/defaults.yml#L64) would be `release/ulmo.2`
You can query your current version with `tutor config printvalue OPENEDX_COMMON_VERSION`
> [@AmbroiseRabier](#):
>
> For anyone having the issue, the fix is simple, set `ATLAS_REVISION: main` in `config.yml`
The correct method to do this in CLI would be `tutor config save --set ATLAS_REVISION=main`
---
### Author:  [@sarina](https://discuss.openedx.org/u/sarina)
#### Post date: [April 13, 2026, 2:51pm UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/4 "2026-04-13T14:51:02Z")
@omar @brian.smith just flagging this post - could you take a look and see if anything in documentation needs to be updated? (I haven’t read it closely)
---
### Author:  [@brian.smith](https://discuss.openedx.org/u/brian.smith)
#### Post date: [April 13, 2026, 4:05pm UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/5 "2026-04-13T16:05:02Z")
To clarify the different ways to use `ATLAS_REVISON`:
- `release/ulmo.1`
- This is the default for someone running `ulmo.1` in Tutor
- It comes from `{{ OPENEDX_COMMON_VERSION }}`
- It is frozen in time (a git tag as opposed to a git branch on the `openedx-translations` repo)
- This is done to enable reproducible builds.
- `release/ulmo`
- This is a git branch on the `openedx-translations` repo
- It will pull the latest translations for the source strings that exist in the `ulmo` named release.
- `main`
- This is also a git branch on the `openedx-translations` repo
- This will pull the latest translations for the source strings that exist in the `main`/`master` branches of the repos to be included in the next named Open edX release
While it is quite likely that pulling from `main` will _work_ for `ulmo`, it is also possible for strings that exist in `ulmo` to get removed in `main`, leading to gaps.
#### I recommend setting `ATLAS_REVISION` to `release/ulmo` instead.
* * *
#### Docs that could be updated:
[The `openedx-translations` README](https://github.com/openedx/openedx-translations/tree/release/ulmo?tab=readme-ov-file#open-releaserelease-namemaster-branch) still mentions the branch naming format we used before `teak` (`open-release/.master`).
[The Tutor documentation for “Getting and customizing Translations”](https://docs.tutor.edly.io/configuration.html#getting-and-customizing-translations) could probably benefit from mentioning setting `release/` (as opposed to `release/.x`) as the recommended way to pull updated translations for any given named release.
---
### Author:  [@sarina](https://discuss.openedx.org/u/sarina)
#### Post date: [April 14, 2026, 2:02am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/6 "2026-04-14T02:02:13Z")
PR to update the readme - [docs: Change release branch naming conventions by sarina · Pull Request #69795 · openedx/openedx-translations · GitHub](https://github.com/openedx/openedx-translations/pull/69795)
PR to update Tutor docs - [docs: Use branch, not tags, for translations by sarina · Pull Request #1368 · overhangio/tutor · GitHub](https://github.com/overhangio/tutor/pull/1368)
---
### Author:  [@omar](https://discuss.openedx.org/u/omar)
#### Post date: [April 14, 2026, 6:39am UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/7 "2026-04-14T06:39:34Z")
The tradeoff is the operator either gets reproducible builds that will always work (or break) by setting a specific tag. Or use `release/ulmo` and expects some builds to fail due to translation updates.
By default, it’s always set to a tag `release/ulmo.1` to ensure reproducible builds for the unsuspecting operator. In practice, everyone needs to use `release/ulmo` instead.
This is intentional and sorry you had to ask, if you’ve got a minute [kindly consider updating the docs](https://docs.tutor.edly.io/configuration.html#getting-and-customizing-translations) so others don’t have to 🙂
---
### Author:  [@sarina](https://discuss.openedx.org/u/sarina)
#### Post date: [April 14, 2026, 2:04pm UTC](https://discuss.openedx.org/t/bug-documentation-translation-main-is-not-default-but-release-ulmo-1/18770/8 "2026-04-14T14:04:43Z")
> [@sarina](#):
>
> PR to update Tutor docs - [docs: Use branch, not tags, for translations by sarina · Pull Request #1368 · overhangio/tutor · GitHub](https://github.com/overhangio/tutor/pull/1368)
@omar I made the changes and had already posted the PR. It looks like the Tutor maintainer just merged it so I hope I got it right 😅