Testing the /article-voice skill (custom) by serhiipylypchuk1991 · Pull Request #85 · DHTMLX/docs-kanban

serhiipylypchuk1991 · 2026-04-01T09:16:14Z

No description provided.

mafanya23 · 2026-04-02T07:42:06Z

docs/guides/configuration.md

+- apply the desired locale via [`locale`](api/config/js_kanban_locale_config.md)
    - *Refer to the [**Localization**](guides/localization.md) section for details!*
- 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
+- load data for cards, columns, rows, and links via [`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)


Здесь описание API было лучше, на мой взгляд
https://github.com/DHTMLX/docs-kanban/pull/83/changes#diff-7174c092c6ae1e7b14c766db2501547b5b20f45e207257d04ee5d649322f94d3R12

mafanya23 · 2026-04-02T07:44:35Z

docs/guides/configuration.md

 ## 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:
+The Kanban board distributes *cards* across *columns* and *rows*. Use the [`cardShape`](api/config/js_kanban_cardshape_config.md) property to control which predefined fields appear on each card:


Здесь хорошо получилось. Оригинал преобразован в более короткое описание, но при этом сохранена вся нужная информация

mafanya23 · 2026-04-02T07:46:51Z

docs/guides/configuration.md


    :::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 of any card via the corresponding inputs in the Kanban editor. If you activate these fields, the editor displays the corresponding inputs automatically. To configure these inputs, use the [**text** and **textarea**](#text-and-textarea-types) types.


(+) использование active voice вместо passive

mafanya23 · 2026-04-02T07:49:24Z

docs/guides/configuration.md


    :::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 of any card via the corresponding control in the Kanban editor. If you activate this field, the editor displays the corresponding control automatically. To configure this control, use the [**progress**](#progress-type) type.


аналогично. Возможно, получилось однообразно, но все же лучше использования местоимений

mafanya23 · 2026-04-02T07:50:54Z

docs/guides/configuration.md


    :::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 the **start date** and **end date** fields of any card via the corresponding controls in the Kanban editor. If you activate these fields, the editor displays the corresponding controls automatically. To configure these controls, use the [**date**](#date-and-daterange-types) type.


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

mafanya23 · 2026-04-02T07:53:04Z

docs/guides/configuration.md

-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:
+The Kanban board distributes *cards* across *columns* and *rows*. Use the [`cardShape`](api/config/js_kanban_cardshape_config.md) property to control which predefined fields appear on each card:

 - a card label via the `label: boolean` config


Возможно, здесь тоже не хватает глаголов, как уже обсуждалось здесь

mafanya23 · 2026-04-02T07:56:38Z

docs/guides/configuration.md

+- card comments via the `comments: boolean` config
+- a confirmation dialog for card deletion via the `confirmDeletion: boolean` config
+- card votes via the `votes: boolean | { show: boolean, clicable: true }` config
+- card assignment (users) via the `users: boolean | { show: boolean, values: object, maxCount: number | false }` config


Правки выглядят логичными. Но по структуре все же в idra более четко получилось
https://github.com/DHTMLX/docs-kanban/pull/83/changes#diff-7174c092c6ae1e7b14c766db2501547b5b20f45e207257d04ee5d649322f94d3R57

mafanya23 · 2026-04-02T07:58:31Z

docs/guides/configuration.md


 :::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 specify card settings via [`cardShape`](api/config/js_kanban_cardshape_config.md), the widget applies the [**defaultCardShape**](api/config/js_kanban_cardshape_config.md#default-config) parameters.


хорошо поправил unless и будущее время

mafanya23 · 2026-04-02T08:05:02Z

docs/guides/configuration.md

 :::

-The *Editor* of Kanban consists of the fields for managing the cards data. To configure the editor fields (controls), you can use the [`editorShape`](api/config/js_kanban_editorshape_config.md) property. You can use the following types of editor fields:
+The editor consists of fields for managing card data. Configure editor fields with [`editorShape`](api/config/js_kanban_editorshape_config.md). The supported field types are:


преобразования чёткие, нужная инфа сохранена

mafanya23 · 2026-04-02T08:05:54Z

docs/guides/configuration.md

 - [**text** and **textarea**](#text-and-textarea-types)
 - [**progress**](#progress-type)
 - [**files**](#files-type)
 - [**date** and **dataRange**](#date-and-daterange-types)


опечатку не исправил, кстати)

mafanya23 · 2026-04-02T08:09:24Z

docs/guides/configuration.md

 ### Combo, Select and Multiselect types

-The editor fields of **combo**, **select**, and **multiselect** types can be set in the following way:
+Set **combo**, **select**, or **multiselect** fields in `editorShape`:


(+) пассивный залог заменил на активный
В предыдущих версиях было еще добавлено хорошее пояснение "for fields with a predefined list of options (priority, tags, assignees, etc.):"

mafanya23 · 2026-04-02T08:10:38Z

docs/guides/configuration.md


 :::info
-For the editor field of **"multiselect"** and **"combo"** types you can also specify a path to the preview image via the **avatar** property:
+For **multiselect** and **combo** fields, specify a path to the preview image via the **avatar** property:


Из всех вариантов самый лучший, на мой взгляд: нет лишнего, но сохранен смысл

mafanya23 · 2026-04-02T08:27:13Z

docs/guides/configuration.md

 ### Date and DateRange types

-The editor field of **date** type can be set in the following way:
+Set a **date** field in `editorShape`:


Здесь и выше, хорошо заменяет пассив на актив, но в idra например, описания получились более развернутыми:
"Use dateRange when you want to bind start and end dates to a single control"
"Use color to let users pick a color for the card's top bar"

mafanya23 · 2026-04-02T08:31:21Z

docs/guides/configuration.md


 :::info
-To link the editor field to the corresponding card field, you need to provide special **key** in the object of [`editorShape`](api/config/js_kanban_editorshape_config.md) property (`key: "editor_field_key"`). The value of this key needs to be set to *true* in the [`cardShape`](api/config/js_kanban_cardshape_config.md) property (for built-in card fields) or specified in the **headerFields** array (for custom card fields). You can provide the initial data of any field via this key as well.
+To link an editor field to the corresponding card field, add a **key** to the field object in [`editorShape`](api/config/js_kanban_editorshape_config.md) (`key: "editor_field_key"`). For built-in card fields, set the matching key to *true* in [`cardShape`](api/config/js_kanban_cardshape_config.md). For custom card fields, add the key to the **headerFields** array. You can also use this key to provide initial field data.


Получился хороший вариант, более краткий, но без пассива, как например здесь

mafanya23 · 2026-04-02T08:31:56Z

docs/guides/configuration.md

        key: "note",
        label: "Note",
        config: {
            placeholder: "Enter usefull note here"


опечатка не исправлена(

mafanya23 · 2026-04-02T08:33:55Z

docs/guides/configuration.md


 :::note
-Unless you specify the editor settings via the [`editorShape`](api/config/js_kanban_editorshape_config.md) property, the widget will apply a [**defaultEditorShape**](api/config/js_kanban_editorshape_config.md#default-config) set of parameters. In this case, the default controls and inputs will be displayed in editor only after activating the corresponding fields of cards via the [`cardShape`](api/config/js_kanban_cardshape_config.md) property.
+If you don't specify editor settings via [`editorShape`](api/config/js_kanban_editorshape_config.md), the widget applies the [**defaultEditorShape**](api/config/js_kanban_editorshape_config.md#default-config) parameters. In this case, the default controls and inputs appear in the editor only after you activate the corresponding card fields via [`cardShape`](api/config/js_kanban_cardshape_config.md).


(+) исправляет unless, будущее время и пассив, не удаляет нужные ссылки

mafanya23 · 2026-04-02T08:36:05Z

docs/guides/configuration.md

- enables/disables an autosave mode of the editor via the *`editor.autoSave`* property
- specify a delay time of autosaving data via the *`editor.debounce`* property (works with the ***autoSave: true*** parameter only)
+- enable autosave via `editor.autoSave`
+- set the autosave delay via `editor.debounce` (requires `autoSave: true`)


хорошо сократил детали без потери смысла

mafanya23 · 2026-04-02T08:37:58Z

docs/guides/configuration.md

 ## 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** contains a search bar, sort controls, and buttons to add columns and rows. Initialize Toolbar in a separate container using the **kanban.Toolbar()** constructor:


тоже хорошо преобразовал в более краткое описание

mafanya23 · 2026-04-02T08:44:53Z

docs/guides/configuration.md

 ~~~

-You can manage (*hide/show/customize*) the Toolbar controls using the **items** property:
+Use the **items** property to hide, show, or customize Toolbar controls:


(+) просто и понятно

mafanya23 · 2026-04-02T08:45:52Z

docs/guides/configuration.md

 ## Example

-In this snippet you can see how to configure the **Cards**, **Editor** and **Toolbar** of Kanban:
+This snippet shows how to configure **Cards**, **Editor**, and **Toolbar** together:


(+) не удалил описание сниппета

mafanya23 · 2026-04-02T08:59:15Z

docs/guides/initialization.md

 # Initialization

-This guide will give you detailed instructions on how to create Kanban on a page to enrich your application with features of the Kanban board. Take the following steps to get a ready-to-use component:
+This guide covers how to add Kanban to a page. Take the following steps to get a ready-to-use component:


(+) оставил всё нужное

idra добавил здесь хорошее summary о конструкторах и аргументах

mafanya23 · 2026-04-02T09:00:37Z

docs/guides/initialization.md

@@ -16,12 +16,12 @@ This guide will give you detailed instructions on how to create Kanban on a page

 [Download the package](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and unpack it into a folder of your project.


здесь осталась конструкция с of

mafanya23 · 2026-04-02T09:08:28Z

docs/how_to_start.md

-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:
+Create an HTML file named *index.html*, then include the Kanban source files:


(+) кратко, понятно

Но наверное здесь и дальше немного теряется повествовательность (нужна ли она в how to start?), только инструкции

mafanya23 · 2026-04-02T09:17:43Z

docs/how_to_start.md

            });

            new kanban.Toolbar("#toolbar", {
                // configuration properties


как уже обсуждалось, здесь стоит учесть api: board.api, как добавлено в idra

mafanya23 · 2026-04-02T09:19:25Z

docs/how_to_start.md


-To start working with Kanban, first you need to provide the initial data for **cards** and **columns** (and *rows*).
-Beside the initial data, you can configure the [cards](guides/configuration.md#cards), [editor](guides/configuration.md#editor) and [toolbar](guides/configuration.md#toolbar) appearance.
+Pass configuration properties to the constructors. At minimum, provide initial data for **cards** and **columns** (and *rows*). You can also configure the [cards](guides/configuration.md#cards), [editor](guides/configuration.md#editor), and [toolbar](guides/configuration.md#toolbar) appearance:


Хорошо перефразировал, при этом сохранен смысл этого step (configure, а не load data)

mafanya23 · 2026-04-02T09:24:39Z

docs/index.md

 # 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.
+JavaScript Kanban is a widget for workflow visualization. It helps you track team workload and understand where work is getting stuck. The component works with any number of cards, columns, and swimlanes. Written in pure JavaScript and CSS, it integrates into any web app or page without extra dependencies.


Оригинал выглядит лучше
(-) использует it вместо хороших синонимов

mafanya23 · 2026-04-02T09:27:35Z

docs/index.md

 ### 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 part of the Kanban interface. It includes a search bar for *searching* cards, a control for *sorting* cards by specified parameters, two controls for managing history (*undo/redo*), and controls for *adding new columns and rows*. You can customize the search and sort logic, add custom elements, or reorder the built-in controls. Read more in the [Configuration](guides/configuration.md#toolbar) section.


неплохой вариант, но "the searching and sorting logic" я бы оставила

mafanya23 · 2026-04-02T09:32:27Z

docs/index.md

 - duplicate cards using a context menu (a 3 dots icon) or the `Ctrl (Command)`+`D` shortcuts (allows duplicating multiple cards)
 - export Kanban data to a JSON file
- managing Kanban history using the following shortcuts:
+- manage Kanban history using the following shortcuts:


хорошо исправил форму глагола для консистентности списка

mafanya23 · 2026-04-02T09:35:29Z

docs/index.md

 ## 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.
+Follow the [How to start](how_to_start.md) guide to add Kanban to your application.


хорошо сократил без потери смысла

Testing the /article-voice skill (custom)

78e0938

serhiipylypchuk1991 self-assigned this Apr 1, 2026

mafanya23 reviewed Apr 2, 2026

View reviewed changes

		@@ -16,12 +16,12 @@ This guide will give you detailed instructions on how to create Kanban on a page

		[Download the package](https://dhtmlx.com/docs/products/dhtmlxKanban/download.shtml) and unpack it into a folder of your project.

Conversation

serhiipylypchuk1991 commented Apr 1, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mafanya23 Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mafanya23 Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mafanya23 Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mafanya23 Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mafanya23 Apr 2, 2026 •

edited

Loading

mafanya23 Apr 2, 2026 •

edited

Loading

mafanya23 Apr 2, 2026 •

edited

Loading

mafanya23 Apr 2, 2026 •

edited

Loading