New translations dcr-toml.mdx (Ukrainian)

[ci skip]

docs-crowdin-export/de-DE/docs/changelog.mdx.mdx

@@ -4,6 +4,16 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
 ## 0.8.4 (2026-08-04)
 
 **Added:**

docs-crowdin-export/de-DE/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `license`     | no       | SPDX license identifier                                                                                         |
+| `author`      | no       | Author                                                                                                          |
 
 ```toml
 [package]
 name = "my-app"
 version = "0.1.0"
+dcr-version = "0.8.4"
 type = "app"
 license = "MIT"
 author = "John Doe"
 ```
 
+### `package.dcr-version`
+
+Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
+
+| Situation                      | Behaviour                                                  |
+| ------------------------------ | ---------------------------------------------------------- |
+| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
+| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
+| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
+| Equal                          | Silent                                                     |
+| Invalid semver                 | Warning once, field ignored                                |
+
+Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
+
 ## [build]
 
 ...

docs-crowdin-export/pl-PL/docs/changelog.mdx.mdx

@@ -4,6 +4,16 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
 ## 0.8.4 (2026-08-04)
 
 **Added:**

docs-crowdin-export/pl-PL/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `license`     | no       | SPDX license identifier                                                                                         |
+| `author`      | no       | Author                                                                                                          |
 
 ```toml
 [package]
 name = "my-app"
 version = "0.1.0"
+dcr-version = "0.8.4"
 type = "app"
 license = "MIT"
 author = "John Doe"
 ```
 
+### `package.dcr-version`
+
+Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
+
+| Situation                      | Behaviour                                                  |
+| ------------------------------ | ---------------------------------------------------------- |
+| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
+| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
+| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
+| Equal                          | Silent                                                     |
+| Invalid semver                 | Warning once, field ignored                                |
+
+Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
+
 ## [build]
 
 ...

docs-crowdin-export/ru-RU/docs/changelog.mdx.mdx

@@ -4,6 +4,16 @@ sidebar_label: Список изменений
 
 # Список изменений
 
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
 ## 0.8.4 (2026-08-04)
 
 **Added:**

docs-crowdin-export/ru-RU/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ sidebar_label: Обзор dcr.toml
 
 ## [пакет]
 
-| Поле       | Обязательное | Описание                                    |
+| Поле          | Обязательное | Описание                                                                                                        |
-| ---------- | ------------ | ------------------------------------------- |
+| ------------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
-| `имя`      | да           | Имя проекта                                 |
+| `имя`         | да           | Имя проекта                                                                                                     |
-| `версия`   | да           | Семантическая версия                        |
+| `версия`      | да           | Semantic version of the **project**                                                                             |
-| `тип`      | no           | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no           | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `лицензия` | нет          | SPDX-идентификатор лицензии                 |
+| `тип`         | нет          | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `автор`    | нет          | Автор                                       |
+| `лицензия`    | нет          | SPDX-идентификатор лицензии                                                                                     |
+| `автор`       | no           | Автор                                                                                                           |
 
 ```toml
 [package]
 name = "my-app"
 version = "0.1.0"
+dcr-version = "0.8.4"
 type = "app"
 license = "MIT"
 author = "John Doe"
 ```
 
+### `package.dcr-version`
+
+Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
+
+| Situation                      | Behaviour                                                  |
+| ------------------------------ | ---------------------------------------------------------- |
+| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
+| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
+| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
+| Equal                          | Silent                                                     |
+| Invalid semver                 | Warning once, field ignored                                |
+
+Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
+
 ## [сборка]
 
 ...

docs-crowdin-export/uk-UA/docs/changelog.mdx.mdx

@@ -4,6 +4,16 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
 ## 0.8.4 (2026-08-04)
 
 **Added:**

docs-crowdin-export/uk-UA/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `license`     | no       | SPDX license identifier                                                                                         |
+| `author`      | no       | Author                                                                                                          |
 
 ```toml
 [package]
 name = "my-app"
 version = "0.1.0"
+dcr-version = "0.8.4"
 type = "app"
 license = "MIT"
 author = "John Doe"
 ```
 
+### `package.dcr-version`
+
+Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
+
+| Situation                      | Behaviour                                                  |
+| ------------------------------ | ---------------------------------------------------------- |
+| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
+| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
+| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
+| Equal                          | Silent                                                     |
+| Invalid semver                 | Warning once, field ignored                                |
+
+Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
+
 ## [build]
 
 ...