Skip to content

docs(editorial policy)#52

Merged
gizeasy merged 47 commits into
masterfrom
docs/editorial-policy
May 27, 2025
Merged

docs(editorial policy)#52
gizeasy merged 47 commits into
masterfrom
docs/editorial-policy

Conversation

@alyonurchick1

@alyonurchick1 alyonurchick1 commented Nov 5, 2024

Copy link
Copy Markdown
Collaborator

closes consta-design-system/uikit#3760

Добавленные разделы:

Разделы будут обновляться по мере добавления новых разделов в связи с:

  1. Обеспечением корректного перехода по ссылкам между разделами
  2. Внедрением нового компонента Informer в доку
  3. Обеспечением консистентности
  4. Вычиткой и редактированием

!Не заливать на портал до момента добавления всех разделов. Я отпишусь, когда добавлю всё

@alyonurchick1

Copy link
Copy Markdown
Collaborator Author

@gizeasy хочу заменить пример компонента на какой-нибудь более простой и короткий. посмотри, пожалуйста, как выйдешь с больничного

@github-actions

github-actions Bot commented Nov 5, 2024

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

github-actions Bot commented Nov 6, 2024

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

github-actions Bot commented Nov 6, 2024

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

github-actions Bot commented Nov 7, 2024

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@alyonurchick1

alyonurchick1 commented Nov 7, 2024

Copy link
Copy Markdown
Collaborator Author

@linturaven , посмотри, пожалуйста, страницу "Структура документации". Получится ли переделать эту схему и другие картинки так, чтобы было красиво и не громоздко.
image

@github-actions

github-actions Bot commented Nov 7, 2024

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@alyonurchick1 alyonurchick1 changed the title docs(editorial policy): add formatting rules docs(editorial policy) Nov 13, 2024
@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design


## Настройки раздела

В файле с раширением `.tsx` вы можете задать настройки раздела:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

раширением -> расширением

Документация состоит из двух типов файлов:

- [страница раздела](#страницы-раздела) – файл с расширением `.mdx`.
- [настройки раздела](#настройки-раздела) – файл с расширением `.tsx`.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Давай будем писать про расширение .ts. .tsx - используется в как обозначение jsx синтаксиса а в настройках его обычно нет. Просто сборка по может кушать и .ts, и.tsx. Но правельнее использовать .ts


Где:

- `title` – название страницы. Оно будет отображаться вверху страницы в качестве заголовка H1.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Заголовок страницы

- `group` – группа (раздел), к которой принадлежит страница. Все группы разделов можно посмотреть в папке `stand` в файле `standConfig.ts`.
- `order` – порядок отображения страницы на портале. Так, чтобы отобразить страницу в первом разделе второй, задайте значение `120`.
- `alias` – ключевые слова для поиска по порталу.
- `description` – краткое описание содержимого страницы. Отображается на портале внизу названия страницы.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Отображается на портале внизу названия страницы.
->
Отображается под заголовком страницы.


Где:

- `title` – название страницы. Оно будет отображаться вверху страницы в качестве заголовка H1.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Заголовок

<>

```jsx
import { createStand } from '##/stand/standConfig';

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Кажется что не нужно спутывать понятия раздел, страница, группа.

createStand - создает страницу, страница может быть о компоненте а может в общем рассказывать о принципах(и т.п.)

Страница существует в группе, группа в библиотеке.

</>
</MdxTabs>

## Страницы раздела

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Вкладки страницы

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

удали

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

удали

- [страница раздела](#страницы-раздела) – файл с расширением `.mdx`.
- [настройки раздела](#настройки-раздела) – файл с расширением `.tsx`.

## Настройки раздела

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

ввести понятие стенда
раздел это стенд

.stand.mdx - главная страница стенда
dev.stand.mdx и прочие tab.stand.mdx - второстипеные страницы

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@alyonurchick1

Copy link
Copy Markdown
Collaborator Author

мб не "предупреждение", а "важно"

@alyonurchick1

Copy link
Copy Markdown
Collaborator Author

@alyonurchick1

Copy link
Copy Markdown
Collaborator Author

убрать блок "Заметки"

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@gizeasy gizeasy force-pushed the master branch 4 times, most recently from 2169f1f to 03848c2 Compare April 29, 2025 12:52
@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

1 similar comment
@github-actions

Copy link
Copy Markdown

🎉 Deployed at http://refs-pull-52-merge---portal.consta.design

@gizeasy gizeasy merged commit a290b92 into master May 27, 2025
5 checks passed
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.

Consta Стайлгайд

2 participants