Skip to content

Testing the /article-voice skill (voice:idra)#83

Open
serhiipylypchuk1991 wants to merge 4 commits intomasterfrom
sp-master-test-skill-idra
Open

Testing the /article-voice skill (voice:idra)#83
serhiipylypchuk1991 wants to merge 4 commits intomasterfrom
sp-master-test-skill-idra

Conversation

@serhiipylypchuk1991
Copy link
Copy Markdown
Contributor

No description provided.

- load data for cards, columns, rows and links via the corresponding [`cards`](api/config/js_kanban_cards_config.md), [`columns`](api/config/js_kanban_columns_config.md), [`rows`](api/config/js_kanban_rows_config.md) and [`links`](api/config/js_kanban_links_config.md) properties
- *Refer to the [**Working with data**](guides/working_with_data.md) section for details!*
Kanban has three configurable areas: **Cards**, **Editor**, and **Toolbar**. Before you start customizing, there's one key concept to understand: cards and editor fields are linked by shared `key` names. When you enable a field on a card and want it to be editable in the editor, the editor control must use the same key. If the keys don't match, the control won't update the card field.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Много воды! Это запутывает. То что в оригинале было на 2 предложения - в переписанной версии растянулось на абзац, но понимание не улучшилось

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна

- [`editor`](api/config/js_kanban_editor_config.md) — editor behavior (autosave, placement)
- [`cardTemplate`](api/config/js_kanban_cardtemplate_config.md) — custom card rendering → see [Customization](guides/customization.md)
- [`locale`](api/config/js_kanban_locale_config.md) — localization → see [Localization](guides/localization.md)
- [`cards`](api/config/js_kanban_cards_config.md), [`columns`](api/config/js_kanban_columns_config.md), [`rows`](api/config/js_kanban_rows_config.md), [`links`](api/config/js_kanban_links_config.md) — data → see [Working with data](guides/working_with_data.md)
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

здесь подход мне кажется немного лучше чем в оригинале, где идет однотипное перечисление типа configure... configure... configure...

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • в spolski тоже список лучше написан, чем в оригинале

## Cards

The board of Kanban consists of the *cards* distributed into *columns* and *rows*. You can configure the cards appearance using the [`cardShape`](api/config/js_kanban_cardshape_config.md) configuration property. There are several predefined fields you can include (or exclude) into the card template, namely:
You'll use [`cardShape`](api/config/js_kanban_cardshape_config.md) to control which fields appear on each card. Set a field to `true` to show it. The available fields are:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Я противник будущего времени в документации! Лучше использовать You can... Use... Handle... Call...

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В spolski: Use cardShape to control which fields appear on each card. Set a field to true to show it, false (or omit it) to hide it.
Выражено лучше у spolski, но в обоих вариантах убрана нужная инфа из оригинала


:::tip
You can manage the **label** and **description** fields of any card via the corresponding inputs of the Kanban editor. If you activate these fields, the corresponding inputs will be displayed in the editor automatically. To configure these inputs, you can use the [**text** and **textarea**](#text-and-textarea-types) types.
You can manage the **label** and **description** fields via the editor. If you activate these fields, the editor inputs appear automatically. To configure the inputs, use the [**text** and **textarea**](#text-and-textarea-types) editor types.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Стало лучше

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Скилл убрал лишнюю инфу, повторяющиеся выражения и будущее время

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spolski: Managed via the label input in the editor. Enable it here and the input appears automatically. Configure it with the text or textarea editor type.

idra лучше мне кажется здесь сработало

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, в этом варианте лучше


:::tip
You can manage the **progress** field of any card via the corresponding control of the Kanban editor. If you activate this field, the corresponding control will be displayed in the editor automatically. To configure this control, you can use the [**progress**](#progress-type) type.
You can manage the **progress** field via the editor. If you activate it, the editor control appears automatically. To configure it, use the [**progress**](#progress-type) editor type.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Мне не нравится использование It и This в документации, поскольку не всегда понятно из контекста на что они указывают

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, согласна - повторяется it в двух предложениях подряд. Нужно, видимо, прописать в скилле, чтобы не заменял сущ на местоимения, если могут быть разночтения (когда непонятно, какое сущ заменяет местоимение)


:::tip
You can manage the **start date** and **end date** fields of any card via the corresponding controls of the Kanban editor. If you activate these fields, the corresponding controls will be displayed in the editor automatically. To configure these controls, you can use the [**date**](#date-and-daterange-types) type.
You can manage **start date** and **end date** via the editor. If you activate these fields, the editor controls appear automatically. To configure them, use the [**date**](#date-and-daterange-types) editor type.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ну вот как понять к чему относится them здесь, не вернувшись обратно к началу абзаца

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Думаю, them здесь относится к editor controls в предыдущем предложении. Но там тогда все равно не хватает corresponding (editor controls), чтобы было понятно, что речь про start/end date


- a card context menu via the `menu: boolean` config
- a card attachment via the `attached: boolean` config
- `menu: boolean` — three-dot context menu on the card
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

как будто бы не хватает действия типа activate, show, display или enable

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • согласна

- a card context menu via the `menu: boolean` config
- a card attachment via the `attached: boolean` config
- `menu: boolean` — three-dot context menu on the card
- `attached: boolean` — file attachments
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

аналогично с комментарием выше


:::tip
You can **attache files** to any card via the corresponding field of the Kanban editor. To configure this field, you can use the [**files**](#files-type) type.
You can attach files to any card via the editor. To configure this field, use the [**files**](#files-type) editor type.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

стало понятнее

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


:::tip
You can manage the **top color line** of any card via the corresponding control of the Kanban editor. If you activate **color**, the corresponding control (*colorpicker*) will be displayed in the editor automatically. To configure this control, you can use the [**color**](#color-type) type.
You can manage the **top color line** via a color picker in the editor. If you activate **color**, the picker appears automatically. To configure it, use the [**color**](#color-type) editor type.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It... плохо


:::tip
You can assign one or several users to any card via the corresponding control of the Kanban editor. To configure the control for assigning a single user, use the [**combo** or **select**](#combo-select-and-multiselect-types) types of editor. To assign multiple users, use the [**multiselect**](#combo-select-and-multiselect-types) type.
You can assign users to a card via the editor. For a single user, use the [**combo** or **select**](#combo-select-and-multiselect-types) editor types. For multiple users, use [**multiselect**](#combo-select-and-multiselect-types).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For a single user, use...
multiple users, use...

Можно заменять в таких случаях user на customer

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В spolski тоже самое. Когда тестировала скилл на этом https://webix.io/dev/svar/svelte-excel-import-svelte/master/docs/guides/column-matching.html, то в одном абзаце раза 4 или 5 было слово match - причем и как глагол и как сущ. В результате в свой кастомизированный добавила промт, чтобы не повторял слова, а где можно, заменял на синонимы (если это не имя/название и не спец термин, который нельзя убрать)


:::note
Unless you specify the card settings via the [`cardShape`](api/config/js_kanban_cardshape_config.md) property, the widget will apply a [**defaultCardShape**](api/config/js_kanban_cardshape_config.md#default-config) set of parameters!
If you don't set `cardShape`, the widget uses [**defaultCardShape**](api/config/js_kanban_cardshape_config.md#default-config).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

проще написано

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, spolski тоже так же исправил


:::info
You can display the Editor as the **sidebar** or **modal window** using the [`editor.placement`](api/config/js_kanban_editor_config.md) property!
You can display the Editor as a **sidebar** or **modal window** using the [`editor.placement`](api/config/js_kanban_editor_config.md) property.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

корректно исправляет артикли и пунктуацию!

- [**progress**](#progress-type)
- [**files**](#files-type)
- [**date** and **dataRange**](#date-and-daterange-types)
- [**date** and **dateRange**](#date-and-daterange-types)
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Исправил опечатку!

### Combo, Select and Multiselect types

The editor fields of **combo**, **select**, and **multiselect** types can be set in the following way:
Use `combo`, `select`, or `multiselect` for fields with a predefined list of options — priority levels, tags, assignees, and similar:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Заменил пассив на актив! Это +

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Но добавил тире, в отличие от варианта выше, где используются скобки. Думаю, в этом случае можно было бы использовать двоеточие

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В новой версии скилла это тоже будет учтено!


:::info
For the editor field of **"multiselect"** and **"combo"** types you can also specify a path to the preview image via the **avatar** property:
`multiselect` and `combo` also support an `avatar` property for preview images:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В оригинале было более понятно, но также оригинал выглядит перегруженым

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spolski Так же исправил. но мне оригинал понятнее

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал лучше

### Color type

The editor field of **color** type can be set in the following way:
Use `color` to let users pick a color for the card's top bar:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

исправил пассив на актив (+)

### Text and Textarea types

The editor fields of **text** and **textarea** types can be set in the following way:
Use `text` for single-line inputs and `textarea` for multi-line ones:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

пассив на актив (+)

### Files type

The editor field of **files** type can be set in the following way:
Use `files` to let users attach files to a card. You can provide the upload URL as a string or as a function — you'll want the function form if you need to add auth headers or transform the response.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Позитив:

  • использует бектики для названия API вместо болда
  • использует актив вместо пассива

Негатив:
использует будущее время

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна. И предложения с тире - основаная фишка ИИ. Надо добавить в скилл и тогда он перефразирует их.

### Date and DateRange types

The editor field of **date** type can be set in the following way:
Use `date` for a single date field:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

актив вместо пассива (+)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use the date parameter to configure a date field. - так было бы лучше

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна

label: "Note",
config: {
placeholder: "Enter usefull note here"
placeholder: "Enter a useful note here"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

поправляет опечатки

### Configuring the editor

Using the [`editor`](api/config/js_kanban_editor_config.md) property, you can configure the editor in the following way:
Use the [`editor`](api/config/js_kanban_editor_config.md) property to configure editor behavior:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Поправил герундий на актив (+100 в карму)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна

## Toolbar

**Toolbar** of Kanban consists of the searchbar for *searching cards* and controls for *sorting cards* and *adding new columns and rows*. To display Toolbar, you need to initialize it in a separate container using the **kanban.Toolbar()** constructor.
The **Toolbar** is a separate component. You initialize it in its own container and connect it to the board via `api`:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it... its... it... (-)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, очень сокращено описание

~~~

You can manage (*hide/show/customize*) the Toolbar controls using the **items** property:
You can control which controls appear — and in what order — using the `items` array. Pass a string to include a built-in control, or an object to customize it:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

control wich controls... (-)

:::tip
To hide some of the Toolbar controls, remove the corresponding string(s) from the **items** array.
To hide a Toolbar control, remove its string from the `items` array.
:::
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал кажется более понятным

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Сокращение в первой части нормальное, а вторую оставила бы из оригинала

~~~

If you want to create the widget along with its *Toolbar*, you need to add a separate container for it:
If you're using the Toolbar, it needs its own container — the Toolbar renders outside the board, not inside it:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

present continuous - не камельфо. Документация это всегда simple tenses

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал лучше


- an HTML container (the ID of the HTML container)
- an object with configuration properties. [See the full list here](#configuration-properties)
Here we initialize the board by passing the container ID and a configuration object to `kanban.Kanban`:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал выглядит более понятным! Here we initialize...? by passing?
Вроде в других разделам он уходит от герундия а здесь наоборот

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Примерно тоже что в spolski. но здесь хотя бы прописал , что мы делаем в примере "Here we initialize the board" https://github.com/DHTMLX/docs-kanban/pull/82/changes/BASE..81d2607de3b7d9dc2f25fd688930807ba15dbacb#r3010426349

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал лучше


new kanban.Toolbar("#toolbar", {
// configuration properties
api: board.api
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

логика в этом есть! Без этой настройки не будет связи между тулбаром и канбаном

:::

### Configuration properties
For the full list of configuration properties:
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

спорно! Разбивка на подразделы выглядит более структурированно

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This clear and comprehensive tutorial will guide your through the steps you need to take in order to get a full-functional Kanban on a page.
This guide walks you through adding a working Kanban board to a page. You'll include the source files, create containers, and initialize both the board and its optional Toolbar.

There are two constructors you'll work with: `kanban.Kanban` for the board and `kanban.Toolbar` for the control bar above it. The Toolbar is optional — if you don't need search or sort controls, you can skip it entirely. When you do use it, it needs its own container and a reference to the board's API.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В целом абзац выглядит норм! Но много будущего времени. Хотя для вступления может и норм, так как это маркетинговая инфа.

В целом есть смысл разделять техническую информацию в документации и маркетинговую! Для технической инфи стиль должен быть более строгим, используем только present simple. Для маркетинговой - более свободный стиль

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spolski не так многословен https://github.com/DHTMLX/docs-kanban/pull/82/changes/BASE..81d2607de3b7d9dc2f25fd688930807ba15dbacb#r3010437154
Но для getting_started все же нужен отдельный скилл, мне кажется. Здесь и правда может быть смесь и технической, и маркетинговой инфы

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тоже добавлен абзац про конструкторы. Но тоже тире + будущее время

Start from creating an HTML file and call it *index.html*. Then proceed to include Kanban source files into the created file.

There are two necessary files:
## Step 1. Include source files
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Актив вместо герундия (+)

~~~

### Installing Kanban via npm or yarn
### Installing via npm or yarn
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

здесь остался герундий (-)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Думаю, это потому, что здесь описательный абзац, а выше была пошаговая инструкция ## Step 1. Include source files

If you want to use trial version of Kanban, download the [**trial Kanban package**](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and follow steps mentioned in the *README* file. Note that trial Kanban is available 30 days only.
**Trial version:** Download the [**trial Kanban package**](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and follow the steps in the *README*. The trial is valid for 30 days.
:::

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Пропущен заголовок сверху!!! Разбивка на секции более приоритетна чем обычный текст (принять во внимание)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Также нужно избегать герундия в заголовках и стремиться к активу (принять во внимание)


:::info
You can access the DHTMLX private **npm** directly in the [Client's Area](https://dhtmlx.com/clients/) by generating your login and password for **npm**. A detailed installation guide is also available there. Please note that access to the private **npm** is available only while your proprietary Kanban license is active.
**PRO version:** You can access the DHTMLX private **npm** registry through the [Client's Area](https://dhtmlx.com/clients/). Generate your credentials there. Access requires an active Kanban license.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(-)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spolsi тоже заголовок убрал, что в минус

## Step 2. Add containers

Now you are ready to add Kanban to the page. First, let's create the DIV containers for Kanban and its Toolbar. So, take the following steps:
Here we add two containers — one for the board, one for the Toolbar. The order in the HTML matters: the Toolbar container should come first so it renders above the board.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(-)
Оригинал здесь конечно не сахар, о и поправленная версия требует доработки

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

оо, idra здесь справился гораздо лучше spolski , мне кажется
У spolski Только вот это:
Add a container for the board, and a second one for the Toolbar if you're using it:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, еще бы двоеточие вместо тире, было бы неплохо в целом

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Учтем!


# DHTMLX Kanban overview

JavaScript Kanban is an effective solution for the workflow visualization. The widget helps you better understand your business processes and gain an overview of your team workload. This flexible tool can work with any number of cards, columns and swimlanes. Fully written in pure JavaScript and CSS, the component can be easily set and customized as well as integrated into any web app or web page.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал все же более понятен

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна. и как писала для spolski - overview - это все же отдельный стиль и скилл

### Board

The **Board** is main part of Kanban. It consists of the cards distributed into columns and rows (swimlanes). You can flexibly configure the cards appearance as well as apply a custom template. Read more in the [Configuration](guides/configuration.md#cards) section.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Опять же оригинал выглядит хорошо

- load data for cards, columns, rows and links via the corresponding [`cards`](api/config/js_kanban_cards_config.md), [`columns`](api/config/js_kanban_columns_config.md), [`rows`](api/config/js_kanban_rows_config.md) and [`links`](api/config/js_kanban_links_config.md) properties
- *Refer to the [**Working with data**](guides/working_with_data.md) section for details!*
Kanban has three configurable areas: **Cards**, **Editor**, and **Toolbar**. Before you start customizing, there's one key concept to understand: cards and editor fields are linked by shared `key` names. When you enable a field on a card and want it to be editable in the editor, the editor control must use the same key. If the keys don't match, the control won't update the card field.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна

- [`editor`](api/config/js_kanban_editor_config.md) — editor behavior (autosave, placement)
- [`cardTemplate`](api/config/js_kanban_cardtemplate_config.md) — custom card rendering → see [Customization](guides/customization.md)
- [`locale`](api/config/js_kanban_locale_config.md) — localization → see [Localization](guides/localization.md)
- [`cards`](api/config/js_kanban_cards_config.md), [`columns`](api/config/js_kanban_columns_config.md), [`rows`](api/config/js_kanban_rows_config.md), [`links`](api/config/js_kanban_links_config.md) — data → see [Working with data](guides/working_with_data.md)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • в spolski тоже список лучше написан, чем в оригинале

## Cards

The board of Kanban consists of the *cards* distributed into *columns* and *rows*. You can configure the cards appearance using the [`cardShape`](api/config/js_kanban_cardshape_config.md) configuration property. There are several predefined fields you can include (or exclude) into the card template, namely:
You'll use [`cardShape`](api/config/js_kanban_cardshape_config.md) to control which fields appear on each card. Set a field to `true` to show it. The available fields are:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В spolski: Use cardShape to control which fields appear on each card. Set a field to true to show it, false (or omit it) to hide it.
Выражено лучше у spolski, но в обоих вариантах убрана нужная инфа из оригинала


:::tip
You can manage the **label** and **description** fields of any card via the corresponding inputs of the Kanban editor. If you activate these fields, the corresponding inputs will be displayed in the editor automatically. To configure these inputs, you can use the [**text** and **textarea**](#text-and-textarea-types) types.
You can manage the **label** and **description** fields via the editor. If you activate these fields, the editor inputs appear automatically. To configure the inputs, use the [**text** and **textarea**](#text-and-textarea-types) editor types.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spolski: Managed via the label input in the editor. Enable it here and the input appears automatically. Configure it with the text or textarea editor type.

idra лучше мне кажется здесь сработало


:::tip
You can manage the **progress** field of any card via the corresponding control of the Kanban editor. If you activate this field, the corresponding control will be displayed in the editor automatically. To configure this control, you can use the [**progress**](#progress-type) type.
You can manage the **progress** field via the editor. If you activate it, the editor control appears automatically. To configure it, use the [**progress**](#progress-type) editor type.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Да, согласна - повторяется it в двух предложениях подряд. Нужно, видимо, прописать в скилле, чтобы не заменял сущ на местоимения, если могут быть разночтения (когда непонятно, какое сущ заменяет местоимение)

## What's next

That's all. Just three simple steps and you have a handy tool for visualizing and managing the workflow. Now you can start working with your tasks or keep exploring the inner world of JavaScript Kanban.
Now that the board is on the page, you may want to:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна


# DHTMLX Kanban overview

JavaScript Kanban is an effective solution for the workflow visualization. The widget helps you better understand your business processes and gain an overview of your team workload. This flexible tool can work with any number of cards, columns and swimlanes. Fully written in pure JavaScript and CSS, the component can be easily set and customized as well as integrated into any web app or web page.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Согласна. и как писала для spolski - overview - это все же отдельный стиль и скилл

### Toolbar

**Toolbar** of Kanban is a separate part of the interface. It includes a search bar for *searching* cards, a control for *sorting* cards by the specified parameters, two controls for managing history (*undo/redo*) and controls for *adding new columns and rows*. You can flexibly manage the searching and sorting logic as well as change the Toolbar structure by adding custom elements or changing the order of the built-in ones. Read more in the [Configuration](guides/configuration.md#toolbar) section.
The **Toolbar** is a separate component that sits above the board. It gives your users a search bar, sort controls, undo/redo buttons, and controls for adding columns and rows.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Здесь idra лучше справился, имхо. чем spolski и в принципе лучше оригинла (если исключить первое предложение с его "sits above the board" - хотя d getting started можно что-то такое допустить, но этот вариант я бы заменила все равно)

- select multiple cards using the following shortcuts:
- `Shift` + clicking on the corresponding cards, to select multiple cards in the same column
- `Ctrl (Command)` + clicking on the corresponding cards, to select multiple cards in different columns
The **Board** is where cards live. Cards are organized into columns (stages) and rows (swimlanes). You can control which fields appear on each card and apply a fully custom card template if the defaults don't fit your use case. See [Configuration](guides/configuration.md#cards).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Смотри https://github.com/DHTMLX/docs-kanban/pull/82/changes/BASE..81d2607de3b7d9dc2f25fd688930807ba15dbacb#r3010533750
Список лучше у ИИ
The Board is where cards live. - тут уж разошелся idra)

### Editor

The **Editor** is a modal panel that consists of the fields and controls for managing the selected card data. To display the editor, click on the card you want to change. You can flexibly configure the editor structure by adding new fields and controls. Read more in the [Configuration](guides/configuration.md#editor) section.
The **Editor** opens when you click a card. It shows the fields for that card's data and lets your users edit them directly.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Здесь лучше чем у spolski https://github.com/DHTMLX/docs-kanban/pull/82/changes/BASE..81d2607de3b7d9dc2f25fd688930807ba15dbacb#r3010539582
Основаня инфа передана.


## Example

In this snippet you can see how to configure the **Cards**, **Editor** and **Toolbar** of Kanban:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

здесь тоже удалена строка


## Example

In this snippet you can see how to initialize **Kanban** with the initial data:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

в обоих вариантах удалено описание примера


- the JS file of Kanban
- the CSS file of Kanban
Create an HTML file and include the two required Kanban files — the JS bundle and the CSS:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


:::info
If you want to use trial version of Kanban, download the [**trial Kanban package**](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and follow steps mentioned in the *README* file. Note that trial Kanban is available 30 days only.
**Trial version:** Download the [**trial Kanban package**](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and follow the steps in the *README*. The trial is valid for 30 days.
Copy link
Copy Markdown
Contributor

@mafanya23 mafanya23 Mar 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

## Step 3. Configuring Kanban

Next you can specify configuration properties you want the Kanban component to have when initialized.
## Step 4. Load data
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Не совсем понятно, почему в обоих случаях этот шаг называется Load data и игнорируется абзац про configuration

DHTMLX Kanban is a JavaScript widget for building Kanban boards. It's written in pure JavaScript and CSS, so you can drop it into any web page or app without framework dependencies.

## Kanban structure­
The widget is made up of three parts: **Toolbar**, **Board**, and **Editor**. Understanding how these relate to each other will help you configure each one correctly — they're loosely coupled, but they share data through a common API.
Copy link
Copy Markdown
Contributor

@mafanya23 mafanya23 Mar 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Вот этот абзац выглядит неплохо в целом, как интро про структуру

**Toolbar** of Kanban is a separate part of the interface. It includes a search bar for *searching* cards, a control for *sorting* cards by the specified parameters, two controls for managing history (*undo/redo*) and controls for *adding new columns and rows*. You can flexibly manage the searching and sorting logic as well as change the Toolbar structure by adding custom elements or changing the order of the built-in ones. Read more in the [Configuration](guides/configuration.md#toolbar) section.
The **Toolbar** is a separate component that sits above the board. It gives your users a search bar, sort controls, undo/redo buttons, and controls for adding columns and rows.

You can customize it: reorder the built-in controls, remove ones you don't need, or inject your own elements. See [Configuration](guides/configuration.md#toolbar) for details.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

здесь даже не тире)

## What's next

Now you can get down to using Kanban in your application. Follow the directions of the [How to start](how_to_start.md) tutorial for guidance.
To add the board to your page, start with [How to start](how_to_start.md).
Copy link
Copy Markdown
Contributor

@mafanya23 mafanya23 Mar 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Оригинал выглядит лучше для гайда

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants