From 6bd52363d78c2062a482ab82a3e1173426e21f18 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Wed, 19 Nov 2025 15:37:06 +0300 Subject: [PATCH 1/8] =?UTF-8?q?=D0=A0=D0=B5=D0=B4=D0=B0=D1=87=D0=B8=D1=82?= =?UTF-8?q?=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=20=D1=80?= =?UTF-8?q?=D0=B5=D0=BF=D0=BE=D0=B7=D0=B8=D1=82=D0=BE=D1=80=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 28 +++++++++++----------------- 1 file changed, 11 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 3fc5e3568b..ec1c00b5e2 100644 --- a/README.md +++ b/README.md @@ -4,32 +4,26 @@ [![Статус проверки ссылок](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml/badge.svg)](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml) [![Статус деплоя](https://github.com/doka-guide/content/workflows/Product%20Deploy/badge.svg)](https://github.com/doka-guide/content/actions?query=workflow%3AProduct%20Deploy) -[⚠️ Если сайт Доки медленно загружается или не работает совсем](docs/load-fix.md) +[Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой 🌚 -[Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Наша цель — сделать документацию по веб-разработке практичной, понятной и не унылой. +> 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её репозиторий](https://github.com/doka-guide/platform/). -📘 Этот репозиторий содержит контент проекта «[Дока](https://doka.guide/)»! +Присоединяйтесь к [нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите в [чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или просто хорошо провести время. -[Главная страница проекта на Гитхабе](https://github.com/doka-guide) +## Как сделать вклад? -Присоединяйтесь к [нашему сообществу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей, или к [чату](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос и просто хорошо провести время. +Все тексты хранятся в формате Markdown, примеры кода — в HTML. Вам не нужно учить сложные инструменты, начать работать легко: -## Как начать? - -Все тексты хранятся в формате Маркдаун, демо — в HTML. Это облегчает работу с ними и не требует дополнительных инструментов. - -1. Сделайте форк этого репозитория. ([Как сделать форк?](https://doka.guide/recipes/github-new-fork/)) -1. Склонируйте форк репозитория на компьютер. ([Как клонировать репозиторий?](https://doka.guide/recipes/github-clone-repo/)) +1. [Сделайте форк](https://doka.guide/recipes/github-new-fork/) этого репозитория. +1. [Склонируйте форк](https://doka.guide/recipes/github-clone-repo/) репозитория на компьютер. 1. Создайте новую ветку. 1. Работайте над материалом и делайте коммиты в процессе работы. -1. Закончили? Создайте пулреквест. ([Как создать пулреквест?](https://doka.guide/recipes/github-new-pull-request/)) - -Вот и всё! После небольшой проверки ваш материал появится на сайте Доки! +1. Закончили? [Создайте пулреквест](https://doka.guide/recipes/github-new-pull-request/). +Вот и всё! Ваш материал проверит добрая редакция и вскоре он появится на сайте Доки! А чтобы ревью прошло быстро, изучите [наши правила](docs/README.md), там есть много важного: готовые шаблоны, руководства по стилю и другие инструкции. -> Подробная [**👉Документация👈**](docs/README.md) на случай, если хочется узнать больше про возможности Доки в плане контента. Например, посмотреть на дизайн-систему или создать свой профиль автора. -Остались вопросы? Приходите в [чат Доки](https://t.me/+qYFPI2mExuQxZTFi). +> ⚠️ Если сайт Доки медленно загружается или не работает совсем, попробуйте [фикс](docs/load-fix.md). --- -Распространяется под лицензиями [CC BY-NC-SA 4.0](LICENSE-SA.md) и [CC BY-NC-ND 4.0](LICENSE-ND.md), подробнее читайте [в документации](docs/license.md). +Распространяется под лицензиями [CC BY-NC-SA 4.0](LICENSE-SA.md) и [CC BY-NC-ND 4.0](LICENSE-ND.md), подробнее читайте в разделе о [лицензиях](docs/license.md). From 2f04afd5343f77f7a300bf1a1ca8d66652332575 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 12:44:24 +0300 Subject: [PATCH 2/8] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=B8=D1=82=20?= =?UTF-8?q?=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D1=83=20=D0=BD=D0=B0=20=D1=81?= =?UTF-8?q?=D0=BE=D1=86=D1=81=D0=B5=D1=82=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Egor Levchenko <50330458+furtivite@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ec1c00b5e2..1d1067d383 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ > 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её репозиторий](https://github.com/doka-guide/platform/). -Присоединяйтесь к [нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите в [чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или просто хорошо провести время. +Присоединяйтесь [к нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите [в чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или просто хорошо провести время. ## Как сделать вклад? From 5e7b3a6b963fbaa4e1ac754e394c7459cd1db390 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 12:45:33 +0300 Subject: [PATCH 3/8] =?UTF-8?q?=D0=A3=D0=B1=D0=B8=D1=80=D0=B0=D0=B5=D1=82?= =?UTF-8?q?=20=D1=8D=D0=BC=D0=BE=D0=B4=D0=B7=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1d1067d383..ccc0f4f7ac 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ [![Статус проверки ссылок](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml/badge.svg)](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml) [![Статус деплоя](https://github.com/doka-guide/content/workflows/Product%20Deploy/badge.svg)](https://github.com/doka-guide/content/actions?query=workflow%3AProduct%20Deploy) -[Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой 🌚 +[Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой. > 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её репозиторий](https://github.com/doka-guide/platform/). From ae2ca0a8864e7a5177226b39f44bc059e06bdb70 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 12:47:57 +0300 Subject: [PATCH 4/8] =?UTF-8?q?=D0=A0=D0=B0=D1=81=D1=88=D0=B8=D1=80=D1=8F?= =?UTF-8?q?=D0=B5=D1=82=20=D1=81=D1=81=D1=8B=D0=BB=D0=BE=D1=87=D0=BA=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Egor Levchenko <50330458+furtivite@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ccc0f4f7ac..8c74c07a13 100644 --- a/README.md +++ b/README.md @@ -26,4 +26,4 @@ --- -Распространяется под лицензиями [CC BY-NC-SA 4.0](LICENSE-SA.md) и [CC BY-NC-ND 4.0](LICENSE-ND.md), подробнее читайте в разделе о [лицензиях](docs/license.md). +Распространяется под лицензиями [CC BY-NC-SA 4.0](LICENSE-SA.md) и [CC BY-NC-ND 4.0](LICENSE-ND.md), подробнее читайте [в разделе о лицензиях](docs/license.md). From 20ff8bdcac9cac6319d7d4d63e5cdf26ec19a6a6 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 12:48:59 +0300 Subject: [PATCH 5/8] =?UTF-8?q?=D0=A3=D0=B1=D0=B8=D1=80=D0=B0=D0=B5=D1=82?= =?UTF-8?q?=20=D0=B4=D1=83=D0=B1=D0=BB=D1=8C=20=D1=81=D0=BB=D0=BE=D0=B2?= =?UTF-8?q?=D0=B0=20=C2=AB=D1=80=D0=B5=D0=BF=D0=BE=D0=B7=D0=B8=D1=82=D0=BE?= =?UTF-8?q?=D1=80=D0=B8=D0=B9=C2=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8c74c07a13..480e8529c6 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ [Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой. -> 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её репозиторий](https://github.com/doka-guide/platform/). +> 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её код](https://github.com/doka-guide/platform/) — он тоже открыт для участия. Присоединяйтесь [к нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите [в чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или просто хорошо провести время. From 33e2cb2fa01456fec6f6c8d4367fe564d3ed5236 Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 12:52:53 +0300 Subject: [PATCH 6/8] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=BD=D0=BE=D1=81?= =?UTF-8?q?=D0=B8=D1=82=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86?= =?UTF-8?q?=D0=B8=D1=8E=20=D0=BF=D1=80=D0=BE=20=D1=84=D0=B8=D0=BA=D1=81=20?= =?UTF-8?q?=D0=BE=D0=B1=D1=80=D0=B0=D1=82=D0=BD=D0=BE=20=D0=BD=D0=B0=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=D1=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 480e8529c6..e98f80f1e7 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ [![Статус проверки ссылок](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml/badge.svg)](https://github.com/doka-guide/content/actions/workflows/link-checker-all.yml) [![Статус деплоя](https://github.com/doka-guide/content/workflows/Product%20Deploy/badge.svg)](https://github.com/doka-guide/content/actions?query=workflow%3AProduct%20Deploy) +> ⚠️ Если сайт Доки медленно загружается или не работает совсем, [попробуйте фикс](docs/load-fix.md). + [Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой. > 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её код](https://github.com/doka-guide/platform/) — он тоже открыт для участия. @@ -22,8 +24,6 @@ Вот и всё! Ваш материал проверит добрая редакция и вскоре он появится на сайте Доки! А чтобы ревью прошло быстро, изучите [наши правила](docs/README.md), там есть много важного: готовые шаблоны, руководства по стилю и другие инструкции. -> ⚠️ Если сайт Доки медленно загружается или не работает совсем, попробуйте [фикс](docs/load-fix.md). - --- Распространяется под лицензиями [CC BY-NC-SA 4.0](LICENSE-SA.md) и [CC BY-NC-ND 4.0](LICENSE-ND.md), подробнее читайте [в разделе о лицензиях](docs/license.md). From f1af74a407764eef2bcd3cd388127a9b909502ae Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 14:11:24 +0300 Subject: [PATCH 7/8] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=BF=D0=B8=D1=81?= =?UTF-8?q?=D1=8B=D0=B2=D0=B0=D0=B5=D1=82=20=D1=87=D0=B0=D1=81=D1=82=D1=8C?= =?UTF-8?q?=20=D1=82=D0=B5=D0=BA=D1=81=D1=82=D0=B0,=20=D0=BD=D0=B5=D0=BC?= =?UTF-8?q?=D0=BD=D0=BE=D0=B3=D0=BE=20=D0=BC=D0=B5=D0=BD=D1=8F=D0=B5=D1=82?= =?UTF-8?q?=20=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=82=D1=83=D1=80=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index e98f80f1e7..e4a9d8740e 100644 --- a/README.md +++ b/README.md @@ -6,23 +6,23 @@ > ⚠️ Если сайт Доки медленно загружается или не работает совсем, [попробуйте фикс](docs/load-fix.md). -[Дока](https://doka.guide/) — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой. +Дока — это добрая энциклопедия для веб-разработчиков. Мы делаем документацию по веб-разработке практичной, понятной и неунылой. -> 📃 Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно поучаствовать в развитии платформы, загляните в [её код](https://github.com/doka-guide/platform/) — он тоже открыт для участия. +Этот репозиторий содержит контент Доки: тексты, картинки, советы и тому подобное. Если вам интересно сделать вклад в развитие платформы, то загляните [в её код](https://github.com/doka-guide/platform/), он тоже открыт для участия. -Присоединяйтесь [к нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите [в чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или просто хорошо провести время. +Присоединяйтесь [к нашему каналу в Телеграм](https://t.me/doka_guide), чтобы быть в курсе последних новостей проекта, и приходите [в чат Доки](https://t.me/+qYFPI2mExuQxZTFi), чтобы пообщаться, задать вопрос или развлечься. -## Как сделать вклад? +## Как сделать вклад -Все тексты хранятся в формате Markdown, примеры кода — в HTML. Вам не нужно учить сложные инструменты, начать работать легко: +Все тексты хранятся в формате Markdown, а примеры кода — в HTML. Вам не нужно учить сложные инструменты для начала работы, сделать вклад легко: -1. [Сделайте форк](https://doka.guide/recipes/github-new-fork/) этого репозитория. -1. [Склонируйте форк](https://doka.guide/recipes/github-clone-repo/) репозитория на компьютер. +1. Форкните этот репозиторий. +1. Клонируйте форк на компьютер. 1. Создайте новую ветку. 1. Работайте над материалом и делайте коммиты в процессе работы. -1. Закончили? [Создайте пулреквест](https://doka.guide/recipes/github-new-pull-request/). +1. Закончили? Создайте пулреквест. -Вот и всё! Ваш материал проверит добрая редакция и вскоре он появится на сайте Доки! А чтобы ревью прошло быстро, изучите [наши правила](docs/README.md), там есть много важного: готовые шаблоны, руководства по стилю и другие инструкции. +Вот и всё! Ваш материал проверит добрая редакция, и он появится на сайте Доки. А чтобы ревью прошло быстрее, изучите [нашу документацию](docs/README.md), там есть много полезного: готовые шаблоны, руководства по стилю и другие инструкции. --- From 9a4f853e6bedccaf2e0c596e378b66da8506777c Mon Sep 17 00:00:00 2001 From: Alexey Nikitchenko Date: Sun, 1 Feb 2026 14:32:27 +0300 Subject: [PATCH 8/8] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D1=8F?= =?UTF-8?q?=D0=B5=D1=82=20=D0=B1=D0=BE=D0=BB=D1=8C=D1=88=D0=B5=20=D0=B2?= =?UTF-8?q?=D0=BD=D0=B8=D0=BC=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=BD=D0=B0=20?= =?UTF-8?q?=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D1=83=20=D0=B2=20=D0=B4=D0=BE?= =?UTF-8?q?=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e4a9d8740e..2dd2258689 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ 1. Работайте над материалом и делайте коммиты в процессе работы. 1. Закончили? Создайте пулреквест. -Вот и всё! Ваш материал проверит добрая редакция, и он появится на сайте Доки. А чтобы ревью прошло быстрее, изучите [нашу документацию](docs/README.md), там есть много полезного: готовые шаблоны, руководства по стилю и другие инструкции. +Вот и всё! Ваш материал проверит добрая редакция, и он появится на сайте Доки. А чтобы лучше во всем разобраться и даже ускорить ревью, изучите [нашу документацию](docs/README.md). В ней есть много полезного: готовые шаблоны, руководства по стилю и другие инструкции. ---