diff --git a/README.md b/README.md index e7023913..10e1eb60 100644 --- a/README.md +++ b/README.md @@ -39,7 +39,7 @@ pnpm run clear Сайт отдаёт MCP-сервер (Model Context Protocol), через который ИИ-агенты могут искать и читать документацию Hexlet. Эндпоинт: -``` +```text https://help.hexlet.io/mcp ``` diff --git a/docs/career/praktika-v-kommercheskih-proektah.md b/docs/career/praktika-v-kommercheskih-proektah.md index a5be9d1f..32738ce0 100644 --- a/docs/career/praktika-v-kommercheskih-proektah.md +++ b/docs/career/praktika-v-kommercheskih-proektah.md @@ -31,34 +31,34 @@ title: "Практика в коммерческих проектах" ## Какие есть проекты 1. **Маркетинговый аналитик Telegram-каналов** - - Разрабатываем платформу для полной аналитики Telegram-каналов и автоматизации маркетинга. - Backlog проекта: https://github.com/Hexlet/tg-marketing-service/issues + + Разрабатываем платформу для полной аналитики Telegram-каналов и автоматизации маркетинга. + Backlog проекта: https://github.com/Hexlet/tg-marketing-service/issues 2. **Hexlet.CV** - - Онлайн-сервис для создания и публикации резюме, ориентированный на разработчиков, аналитиков, тестировщиков и специалистов смежных профессий. - Backlog проекта: https://github.com/Hexlet/hexlet-cv/issues + + Онлайн-сервис для создания и публикации резюме, ориентированный на разработчиков, аналитиков, тестировщиков и специалистов смежных профессий. + Backlog проекта: https://github.com/Hexlet/hexlet-cv/issues 3. **Runit** - - Онлайн-песочница для запуска кода прямо в браузере. Сервис позволяет писать, запускать и тестировать код на разных языках без необходимости установки локального окружения. - Backlog проекта: https://github.com/hexlet-rus/runit/issues + + Онлайн-песочница для запуска кода прямо в браузере. Сервис позволяет писать, запускать и тестировать код на разных языках без необходимости установки локального окружения. + Backlog проекта: https://github.com/hexlet-rus/runit/issues 4. **Аналитика вакансий** - - Сервис, который автоматически собирает вакансии с ключевых платформ (hh.ru, SuperJob, Habr Career, Telegram-каналы) и строит аналитику по IT-рынку труда. - Backlog проекта: https://github.com/Hexlet/hexlet-vacancy-analysis + + Сервис, который автоматически собирает вакансии с ключевых платформ (hh.ru, SuperJob, Habr Career, Telegram-каналы) и строит аналитику по IT-рынку труда. + Backlog проекта: https://github.com/Hexlet/hexlet-vacancy-analysis 5. **Hexlet SICP** - - Онлайн-версия классического курса Structure and Interpretation of Computer Programs (SICP), адаптированная для интерактивного обучения. - Backlog проекта: https://github.com/Hexlet/hexlet-sicp/issues + + Онлайн-версия классического курса Structure and Interpretation of Computer Programs (SICP), адаптированная для интерактивного обучения. + Backlog проекта: https://github.com/Hexlet/hexlet-sicp/issues 6. **Автопостинг** - - Сервис для автоматизации публикаций в социальных сетях. Он помогает планировать, создавать и размещать контент сразу в нескольких соцсетях через единый интерфейс. - Backlog проекта: https://github.com/Hexlet/hexlet-autoposting/tree/main + + Сервис для автоматизации публикаций в социальных сетях. Он помогает планировать, создавать и размещать контент сразу в нескольких соцсетях через единый интерфейс. + Backlog проекта: https://github.com/Hexlet/hexlet-autoposting/tree/main ## Что нужно знать, чтобы начать @@ -88,7 +88,7 @@ Issue помечаются лейблами, которые обозначают Если не уверены, актуальна ли задача или свободна ли она (например, кто-то написал, что забрал её, но так и не приступил), уточните это также в чате. -**Когда нашли задачу, которую готовы выполнить:** +**Когда нашли задачу, которую готовы выполнить:** - напишите комментарий к задаче, что берёте её в работу, - сообщите об этом в чате проекта. @@ -108,4 +108,4 @@ Issue помечаются лейблами, которые обозначают **Сообщайте обо всех сложностях**, которые возникают во время работы над проектом, менеджеру проекта и другим членам команды. В отличие от учебных задач, участие в коммерческих проектах Хекслета — это реальная разработка вместе с другими людьми. А значит, у вас есть отличная возможность получить опыт взаимодействия с командой, который пригодится и для работы в других компаниях. -Команда поможет вам справиться с трудностями, но для этого нужно о них рассказать, поэтому не стесняйтесь просить о помощи. Это верно не только для технических, но и для организационных проблем: обязательно сообщайте, если вам не хватает времени на выполнение задачи или вы хотите отказаться от неё. \ No newline at end of file +Команда поможет вам справиться с трудностями, но для этого нужно о них рассказать, поэтому не стесняйтесь просить о помощи. Это верно не только для технических, но и для организационных проблем: обязательно сообщайте, если вам не хватает времени на выполнение задачи или вы хотите отказаться от неё. diff --git a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-go/kak-chitat-vyvod-testov-v-go.md b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-go/kak-chitat-vyvod-testov-v-go.md index 51f728ee..fd4d34e5 100644 --- a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-go/kak-chitat-vyvod-testov-v-go.md +++ b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-go/kak-chitat-vyvod-testov-v-go.md @@ -12,21 +12,21 @@ title: "Как читать вывод тестов в Go" Когда тесты завершатся, на вкладке Вывод появится результат проверки. Если на этом этапе возникла ошибка, нужно прочитать вывод тестов. Этот вывод — наш главный помощник в отладке кода. -# Виды ошибок +## Виды ошибок Никто не пишет код идеально. Поэтому рано или поздно вы столкнетесь с ошибками. Ошибки при выполнении упражнения можно условно разделить на три вида: -* Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы -* Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы -* Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату +- Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы +- Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы +- Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату -## Ошибки компиляции +### Ошибки компиляции Например, к этому типу ошибок относятся: -* Синтаксическая ошибка -* Обращение к несуществующей переменной -* Использование неправильных типов данных +- Синтаксическая ошибка +- Обращение к несуществующей переменной +- Использование неправильных типов данных Если программа на Go написана синтаксически некорректно, то компилятор выводит на экран сообщение об ошибке. @@ -36,11 +36,11 @@ title: "Как читать вывод тестов в Go" Сообщение об ошибке содержит: -* Описание ошибки -* Указание на файл, в котором произошла ошибка -* Строчку в файле, где произошла ошибка +- Описание ошибки +- Указание на файл, в котором произошла ошибка +- Строчку в файле, где произошла ошибка -## Ошибки времени выполнения +### Ошибки времени выполнения Эти ошибки не препятствуют компиляции, но при этом программа не работает так, как ожидается. @@ -54,7 +54,7 @@ title: "Как читать вывод тестов в Go" Если описания недостаточно, всегда можно обратиться к документации, в которой описаны случаи возникновения тех или иных ошибок. -## Ошибки утверждений +### Ошибки утверждений Такие ошибки возникают, если результат работы функции не соответствует тому результату, который мы ожидали. @@ -72,15 +72,15 @@ title: "Как читать вывод тестов в Go" Здесь мы видим: -* Файл с тестами — `main_test.go` -* Номер строки с непройденным тестом — `main_test.go:16` -* Имя самого теста, который не прошел — `Test: TestSafeWrite` -* Ожидаемый результат работы — в строчке `expected` -* Фактический результат работы кода — в строчке `actual` +- Файл с тестами — `main_test.go` +- Номер строки с непройденным тестом — `main_test.go:16` +- Имя самого теста, который не прошел — `Test: TestSafeWrite` +- Ожидаемый результат работы — в строчке `expected` +- Фактический результат работы кода — в строчке `actual` Изучив такой вывод, мы можем разобраться, чем вызвано несовпадение результатов. Это поможет устранить причину неправильной работы тестируемого кода. -# Отладка кода +## Отладка кода Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение кода. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода. diff --git a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-java.md b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-java.md index 8351a734..959ddaeb 100644 --- a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-java.md +++ b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-java.md @@ -12,23 +12,23 @@ title: "Как читать вывод тестов в Java" Когда тесты завершатся, на вкладке Вывод появится результат проверки. Если на этом этапе возникла ошибка, нужно прочитать вывод тестов. Этот вывод — наш главный помощник в отладке кода. -# Виды ошибок +## Виды ошибок Никто не пишет код идеально. Поэтому рано или поздно вы столкнетесь с ошибками. Ошибки при выполнении упражнения можно условно разделить на три вида: -* Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы -* Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы -* Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату +- Ошибки компиляции — это синтаксические ошибки, которые возникают еще на этапе компиляции программы +- Ошибки времени исполнения – такие ошибки не мешают компиляции, но препятствуют выполнению программы +- Ошибки утверждений — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату -## Ошибки компиляции +### Ошибки компиляции Как видно из названия, такие ошибки возникают еще на этапе компиляции и препятствуют успешному компилированию кода. Они возникают из-за различного рода ошибок в самом тексте кода. Например, к этому типу ошибок относятся: -* Синтаксическая ошибка — пропущенная точка с запятой, незакрытая скобка -* Обращение к несуществующей переменной -* Использование неправильных типов данных +- Синтаксическая ошибка — пропущенная точка с запятой, незакрытая скобка +- Обращение к несуществующей переменной +- Использование неправильных типов данных Если программа на Java написана синтаксически некорректно, то компилятор выводит на экран сообщение об ошибке. @@ -38,11 +38,11 @@ title: "Как читать вывод тестов в Java" Сообщение об ошибке содержит: -* Описание ошибки -* Указание на файл, в котором произошла ошибка -* Строчку в файле, где произошла ошибка +- Описание ошибки +- Указание на файл, в котором произошла ошибка +- Строчку в файле, где произошла ошибка -## Ошибки времени выполнения +### Ошибки времени выполнения Эти ошибки не препятствуют компиляции, но при этом программа не работает так, как ожидается. @@ -60,7 +60,7 @@ title: "Как читать вывод тестов в Java" Если описания недостаточно, всегда можно обратиться к документации, в которой описаны случаи возникновения тех или иных исключений. -## Ошибки утверждений +### Ошибки утверждений Такие ошибки возникают, если результат работы функции не соответствует тому результату, который мы ожидали. @@ -80,14 +80,14 @@ title: "Как читать вывод тестов в Java" Здесь мы видим: -* Имя класса с тестами — `AppTest` -* Имя самого теста, который не прошел — `testTruncate()` -* Ожидаемый результат работы — в строчке `expected` -* Фактический результат работы кода — в строчке `but was` +- Имя класса с тестами — `AppTest` +- Имя самого теста, который не прошел — `testTruncate()` +- Ожидаемый результат работы — в строчке `expected` +- Фактический результат работы кода — в строчке `but was` Изучив такой вывод, мы можем разобраться, чем вызвано несовпадение результатов. Это поможет устранить причину неправильной работы тестируемого кода. -# Отладка кода +## Отладка кода Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение кода. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода. diff --git a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-php.md b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-php.md index d2cb646f..3af6b3e2 100644 --- a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-php.md +++ b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-php.md @@ -12,21 +12,21 @@ title: "Как читать вывод тестов в PHP" После этого на вкладке Вывод можно увидеть результат проверки. И вот здесь, если возникают ошибки, могут быть трудности с пониманием того, что происходит. Здесь нам поможет чтение вывода тестов — нашего главного помощника в отладке кода. -# Виды ошибок +## Виды ошибок Никто не пишет код идеально. Поэтому рано или поздно вам придется столкнуться с ошибками. И понимание, какого вида ошибка, поможет вам разобраться в корне проблемы. Условно ошибки, возникающие при выполнении упражнения, можно разделить на два вида: -* ошибки интерпретатора — разного рода ошибки и исключения, встроенные в PHP. -* ошибки утверждений (AssertionError) — вызванные тестами. Результат работы функции не соответствует ожидаемому результату. +- ошибки интерпретатора — разного рода ошибки и исключения, встроенные в PHP. +- ошибки утверждений (AssertionError) — вызванные тестами. Результат работы функции не соответствует ожидаемому результату. -## Ошибки интерпретатора +### Ошибки интерпретатора Ошибки интерпретатора можно условно разделить на две категории: -* синтаксические ошибки -* семантические ошибки, которые чаще называют исключениями. +- синтаксические ошибки +- семантические ошибки, которые чаще называют исключениями. **Синтаксические ошибки (SyntaxError)** — это нарушение синтаксиса и пунктуации языка. Во время запуска интерпретатор PHP не понимает, как прочесть ошибочное выражение, и вызывает ошибку **SyntaxError**. Пропустили знак доллара перед именем переменной — интерпретатор покажет ошибку. @@ -40,7 +40,7 @@ title: "Как читать вывод тестов в PHP" Важно понять, что данные ошибки не связаны с тестами и сигнализируют о проблеме в коде. -## Утверждения +### Утверждения Отдельно стоит выделить ошибки утверждений. Данные ошибки возникают в случае несоответствия ожидаемого значения с результатом работы функции. @@ -68,13 +68,13 @@ title: "Как читать вывод тестов в PHP" Он очень похож на предыдущий, но здесь сравниваются два массива. Ожидаемый и фактически полученный при вызове функции. -* со знаком «`-`»  указывается ожидаемый результат -* со знаком «`+`»  указывается полученный результат, который не ожидался -* без отметки – результат, который совпадает с ожидаемым +- со знаком «`-`»  указывается ожидаемый результат +- со знаком «`+`»  указывается полученный результат, который не ожидался +- без отметки – результат, который совпадает с ожидаемым По выводу выше мы можем сказать, что был получен массив `[1, 1]`, а должен был `[1, 3]`. -## Отладка кода +### Отладка кода Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение функции. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода. Существует несколько способов, но мы рассмотрим самый простой и распространенный — отладочную печать. diff --git a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-python.md b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-python.md index 57443983..4eb2c790 100644 --- a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-python.md +++ b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-python.md @@ -10,21 +10,21 @@ title: "Как читать вывод тестов в Python" После этого на вкладке Вывод можно увидеть результат проверки. И вот здесь, при возникновении ошибок, возникают трудности с пониманием того, что происходит. Здесь нам поможет чтение вывода тестов — нашего главного помощника в отладке кода. -# Виды ошибок +## Виды ошибок Никто не пишет код идеально. Поэтому рано или поздно вам придется столкнуться с ошибками. И понимание, какого вида ошибка, поможет вам разобраться в корне проблемы. Условно ошибки, возникающие при выполнении упражнения, можно разделить на два вида: -* ошибки интерпретатора — разного рода ошибки и исключения, встроенные в Python. -* ошибки утверждений (AssertionError) — ошибка, вызванная тестами. Результат работы функции не соответствует ожидаемому результату. +- ошибки интерпретатора — разного рода ошибки и исключения, встроенные в Python. +- ошибки утверждений (AssertionError) — ошибка, вызванная тестами. Результат работы функции не соответствует ожидаемому результату. -## Ошибки интерпретатора +### Ошибки интерпретатора Ошибки интерпретатора можно условно разделить на две категории: -* синтаксические ошибки -* семантические ошибки, которые чаще называют исключениями. +- синтаксические ошибки +- семантические ошибки, которые чаще называют исключениями. **Синтаксические ошибки (SyntaxError)** — это нарушение синтаксиса и пунктуации языка. Во время запуска интерпретатор Python не понимает, как прочесть ошибочное выражение, и вызывает ошибку **SyntaxError**. Пропустили двоеточие — интерпретатор укажет на место, где оно ожидается. @@ -38,7 +38,7 @@ title: "Как читать вывод тестов в Python" Важно понять, что данные ошибки не связаны с тестами и сигнализируют о проблеме в коде. -## AssertionError +### AssertionError Отдельно стоит выделить ошибки утверждений (AssertionError). Данные ошибки возникают в случае несоответствия ожидаемого значения с результатом работы функции. @@ -52,13 +52,13 @@ title: "Как читать вывод тестов в Python" ![](/img/docs/img-023.png) -* со знаком «`-`» указывается ожидаемый результат -* со знаком «`+`» указывается результат работы тестируемой функции -* со знаком «`?`» указывается результат сравнения: знаком + указаны участки, которые встречаются только в результате работы функции, знаком «`-`» указаны места, которые есть только в ожидаемом результате +- со знаком «`-`» указывается ожидаемый результат +- со знаком «`+`» указывается результат работы тестируемой функции +- со знаком «`?`» указывается результат сравнения: знаком + указаны участки, которые встречаются только в результате работы функции, знаком «`-`» указаны места, которые есть только в ожидаемом результате После этого стоит задуматься, чем конкретно вызвано несовпадение результатов, и устранить причину неправильной работы тестируемой функции. -## Отладка кода +### Отладка кода Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение функции. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода. Существует несколько способов, но мы рассмотрим самый простой и распространенный — отладочную печать. diff --git a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-ruby.md b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-ruby.md index 7332dfb6..9592a946 100644 --- a/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-ruby.md +++ b/docs/code-and-test-errors/kak-chitat-vyvod-testov-v-ruby.md @@ -12,19 +12,19 @@ title: "Как читать вывод тестов в Ruby" Когда тесты завершатся, на вкладке Вывод появится результат проверки. Если на этом этапе возникла ошибка, нужно прочитать вывод тестов. Этот вывод — наш главный помощник в отладке кода. -# Виды ошибок +## Виды ошибок Никто не пишет код идеально. Поэтому рано или поздно вы столкнетесь с ошибками. Ошибки при выполнении упражнения можно условно разделить на два вида: -* Ошибки интерпретатора — разного рода синтаксические ошибки и исключения, встроенные в Ruby -* Ошибки утверждений (AssertionError) — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату +- Ошибки интерпретатора — разного рода синтаксические ошибки и исключения, встроенные в Ruby +- Ошибки утверждений (AssertionError) — ошибки, вызванные тестами. Они возникают, если результат работы функции не соответствует ожидаемому результату -## Ошибки интерпретатора +### Ошибки интерпретатора Ошибки интерпретатора можно условно разделить на две категории: -* синтаксические ошибки -* семантические ошибки, которые чаще называют исключениями. +- синтаксические ошибки +- семантические ошибки, которые чаще называют исключениями. **Синтаксические ошибки (SyntaxError)** — это нарушение синтаксиса и пунктуации языка. Во время запуска интерпретатор Ruby вызывает ошибку **SyntaxError**, потому что не понимает, как прочесть ошибочное выражение. **Если вы пропустили двоеточие, интерпретатор укажет на место, где оно ожидается:** @@ -45,7 +45,7 @@ title: "Как читать вывод тестов в Ruby" ![](/img/docs/img-028.png) -## Ошибки утверждений +### Ошибки утверждений Такие ошибки возникают, если результат работы функции не соответствует тому результату, который мы ожидали. @@ -63,15 +63,15 @@ title: "Как читать вывод тестов в Ruby" Здесь мы видим: -* Название теста, на котором выполнение остановилось — `test_0001_should works` -* Файл и строка с ошибкой — `[test.rb:12]` -* Само описание проблемы — при сравнении строки `‘**3521’`  с ожидаемым результатом функция вернула `false`. Чтобы этот тест-кейс считался пройденным, сравнение должно вернуть `true`. -* Фактический результат вызова `prepare_card_for_display(card_number1)`, который равен `"**521"` -* Значение параметра, переданного внутрь функции — `"102983470123521"` +- Название теста, на котором выполнение остановилось — `test_0001_should works` +- Файл и строка с ошибкой — `[test.rb:12]` +- Само описание проблемы — при сравнении строки `‘**3521’`  с ожидаемым результатом функция вернула `false`. Чтобы этот тест-кейс считался пройденным, сравнение должно вернуть `true`. +- Фактический результат вызова `prepare_card_for_display(card_number1)`, который равен `"**521"` +- Значение параметра, переданного внутрь функции — `"102983470123521"` Изучив такой вывод, мы можем разобраться, чем вызвано несовпадение результатов. Это поможет устранить причину неправильной работы тестируемого кода. -# Отладка кода +## Отладка кода Иногда с первого взгляда невозможно понять, чем вызвано неправильное поведение кода. Тогда на помощь приходит отладка — возможность заглянуть в процесс выполнения кода. diff --git a/docs/code-and-test-errors/kak-naiti-oshibki-v-kode.md b/docs/code-and-test-errors/kak-naiti-oshibki-v-kode.md index f3be271c..4afac716 100644 --- a/docs/code-and-test-errors/kak-naiti-oshibki-v-kode.md +++ b/docs/code-and-test-errors/kak-naiti-oshibki-v-kode.md @@ -12,9 +12,9 @@ title: "Как найти ошибки в коде" Также загляните в наш Твиттер. В одном треде мы разобрали несколько примеров, когда вроде бы рабочий код не проходит тесты в Хекслете. Сам тред можно найти [здесь](https://twitter.com/hexlethq/status/1545686617561628673?s=46&t=LbgDoYiyYsD-qadPmF522A). -*Примеры в этой статье написаны на языке JavaScript, но принципы одинаковы для любого языка.* +_Примеры в этой статье написаны на языке JavaScript, но принципы одинаковы для любого языка._ -# Тесты +## Тесты Код в Хекслете проверяется с помощью [автоматических тестов](https://ru.wikipedia.org/wiki/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5_%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5). Обычно они написаны на том же языке, на котором написан сам код. Общий принцип работы такого вида тестирования довольно прост. Тестируемая программа загружается в память и вызывается с разными параметрами, а тесты следят за тем, чтобы ее поведение соответствовало ожидаемому. @@ -22,10 +22,10 @@ title: "Как найти ошибки в коде" В первую очередь нужно классифицировать проблему. Ошибки в тестах можно грубо разделить на две категории: -* ошибки, которые выдает компилятор или интерпретатор: синтаксическая ошибка, ошибка типизации -* ошибочные утверждения +- ошибки, которые выдает компилятор или интерпретатор: синтаксическая ошибка, ошибка типизации +- ошибочные утверждения -# Утверждения +## Утверждения Утверждение — это специальная функция, которая вызывает ваш код с определенными параметрами и проверяет, что он возвращает ожидаемый результат. Например: @@ -39,18 +39,18 @@ title: "Как найти ошибки в коде" Вывод можно разделить на две части: -* Первая — описание того, что ожидалось от функции и что было получено. В нашем примере это строка `AssertionError: 3 == 1` . Читается она следующим образом: «ожидалось, что функция вернет 3, но она вернула 1». Это уже хорошо, но еще хотелось бы увидеть, с какими параметрами была вызвана функция. И в этом нам поможет вторая часть вывода. -* Вторая часть называется backtrace, она содержит список функций, которые последовательно вызывались в коде. Порядок вывода, чаще всего, обратный: в начале то, что вызывалось последним. +- Первая — описание того, что ожидалось от функции и что было получено. В нашем примере это строка `AssertionError: 3 == 1` . Читается она следующим образом: «ожидалось, что функция вернет 3, но она вернула 1». Это уже хорошо, но еще хотелось бы увидеть, с какими параметрами была вызвана функция. И в этом нам поможет вторая часть вывода. +- Вторая часть называется backtrace, она содержит список функций, которые последовательно вызывались в коде. Порядок вывода, чаще всего, обратный: в начале то, что вызывалось последним. В первую очередь нужно, начиная с конца, найти первое упоминание функции из файла, который похож на тестовый. Обычно его называние содержит слово test. В примере выше это `at Object. (test.js:4:8)`. В скобках указана строчка, на которой находится вызов этого утверждения. В данном случае — строчка 4. Всё, что теперь остается, это зайти в соответствующий файл и посмотреть то, как вызывалась ваша функция. -# Предупреждения компилятора и интерпретатора +## Предупреждения компилятора и интерпретатора -## Синтаксические ошибки +### Синтаксические ошибки Самый простой тип ошибок. Такая ошибка говорит о том, что вы ошиблись в синтаксисе. Забыли запятую, скобку и тому подобные вещи. Такие ошибки легко находить и исправлять. Синтаксическая ошибка сопровождается текстом, по которому можно загуглить возможные причины. -## Другие ошибки +### Другие ошибки Большой класс ошибок, которые могут возникать в процессе разработки. В выводе компилятора или интерпретатора всегда присутствует сообщение об ошибке, которое очень важно понять. Проще всего сделать, загуглив текст ошибки. Рекомендуем наш гайд [Как искать техническую информацию](https://ru.hexlet.io/blog/posts/how-to-search). diff --git a/docs/code-and-test-errors/otladka-v-uprazhneniyah-po-frontendu.md b/docs/code-and-test-errors/otladka-v-uprazhneniyah-po-frontendu.md index 348dfba8..073afdb3 100644 --- a/docs/code-and-test-errors/otladka-v-uprazhneniyah-po-frontendu.md +++ b/docs/code-and-test-errors/otladka-v-uprazhneniyah-po-frontendu.md @@ -35,6 +35,6 @@ title: "Отладка в упражнениях по фронтенду" Если вы пока учитесь самостоятельно, то можете обратиться к другим студентам в [нашем Сообществе](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). Если вы учитесь с наставником, обратитесь к нему, наставник поможет разобраться. А чтобы в вопросе легко мог разобраться другой человек: -* напишите, как вы думаете, почему произошла ошибка -* [сохраните](/docs/practice/kak-sohranit-svoe-reshenie.md) ваше решение и вставьте ссылку на него в сообщение -* хорошо, если в сохранённом решении будет отладочная печать — это позволит участникам сообщества получить максимум информации, чтобы помочь вам разобраться. +- напишите, как вы думаете, почему произошла ошибка +- [сохраните](/docs/practice/kak-sohranit-svoe-reshenie.md) ваше решение и вставьте ссылку на него в сообщение +- хорошо, если в сохранённом решении будет отладочная печать — это позволит участникам сообщества получить максимум информации, чтобы помочь вам разобраться. diff --git a/docs/community-and-media/blog-heksleta.md b/docs/community-and-media/blog-heksleta.md index ad134c3c..a8b32ab0 100644 --- a/docs/community-and-media/blog-heksleta.md +++ b/docs/community-and-media/blog-heksleta.md @@ -13,4 +13,3 @@ title: "Блог Хекслета" А ещё мы рассказываем истории успеха наших студентов — о том, как они пришли в программирование, какие трудности преодолели и как нашли свою первую работу в новой профессии. Эти истории вдохновляют и показывают, что путь в IT возможен для каждого. **[Ссылка на наш блог — https://ru.hexlet.io/blog](https://ru.hexlet.io/blog)** - diff --git a/docs/corporate-access/oplatit-obuchenie.md b/docs/corporate-access/oplatit-obuchenie.md index 2af9e041..f186b2d4 100644 --- a/docs/corporate-access/oplatit-obuchenie.md +++ b/docs/corporate-access/oplatit-obuchenie.md @@ -22,6 +22,6 @@ title: "Оплатить обучение" Если остались вопросы по оплате с помощью банковской карты, пишите на b2b@hexlet.io — вам ответит живой человек из команды Хекслета. -# По счету +## По счету Для оплаты по безналу мы выставим счёт в российских рублях, а после предоставим закрывающие документы. Пишите на b2b@hexlet.io diff --git a/docs/faq/chto-delat-esli-u-menya-avtorizatsiya-cherez-google.md b/docs/faq/chto-delat-esli-u-menya-avtorizatsiya-cherez-google.md index 963e1ce0..340fcdff 100644 --- a/docs/faq/chto-delat-esli-u-menya-avtorizatsiya-cherez-google.md +++ b/docs/faq/chto-delat-esli-u-menya-avtorizatsiya-cherez-google.md @@ -8,11 +8,11 @@ title: "Что делать, если у меня авторизация чер > Рассказываем, как не потерять доступ к профилю. -С 1 января 2025 года из-за нововведений в законодательстве РФ мы убрали авторизацию через Google, но вы всё еще можете использовать -для входа в Хекслет почту, которая привязана к вашему аккаунту Google. +С 1 января 2025 года из-за нововведений в законодательстве РФ мы убрали авторизацию через Google, но вы всё еще можете использовать +для входа в Хекслет почту, которая привязана к вашему аккаунту Google. -А **установить пароль** для входа в аккаунт Хекслета можно +А **установить пароль** для входа в аккаунт Хекслета можно через форму восстановления пароля по этой ссылке: https://ru.hexlet.io/remind_password/new -Также есть другой вариант: вы можете сменить в футере Хеклета язык на английский и авторизация через старые сервисы будет +Также есть другой вариант: вы можете сменить в футере Хеклета язык на английский и авторизация через старые сервисы будет доступна. А после авторизации можете снова вернуться в русскоязычную локаль сайта. diff --git a/docs/faq/deti-mogut-uchitsya.md b/docs/faq/deti-mogut-uchitsya.md index 0238956e..8e09e4c1 100644 --- a/docs/faq/deti-mogut-uchitsya.md +++ b/docs/faq/deti-mogut-uchitsya.md @@ -8,7 +8,7 @@ title: "Дети могут учиться?" > Рассказываем, с какого возвраста можно учиться в Хекслете. -По правилам платформы, пользователи должны быть **старше 13 лет**. В целом курсы рассчитаны на взрослых, но к нам нередко приходят учиться и ребята 15–16 лет, +По правилам платформы, пользователи должны быть **старше 13 лет**. В целом курсы рассчитаны на взрослых, но к нам нередко приходят учиться и ребята 15–16 лет, особенно если им интересна веб-разработка 🙂 С условиями использования платформы можно ознакомиться здесь: https://ru.hexlet.io/pages/tos diff --git a/docs/faq/gde-naiti-spisok-vseh-vseh-kursov/gde-naiti-spisok-vseh-vseh-kursov.md b/docs/faq/gde-naiti-spisok-vseh-vseh-kursov/gde-naiti-spisok-vseh-vseh-kursov.md index 2b58a5ab..95aa38cc 100644 --- a/docs/faq/gde-naiti-spisok-vseh-vseh-kursov/gde-naiti-spisok-vseh-vseh-kursov.md +++ b/docs/faq/gde-naiti-spisok-vseh-vseh-kursov/gde-naiti-spisok-vseh-vseh-kursov.md @@ -8,7 +8,7 @@ title: "Где найти список всех-всех курсов?" > Рассказываем, как найти список курсов. -Такой страницы, чтобы на ней были собраны вообще все-все курсы, у нас нет. Мы сторонники немного другого подхода, когда +Такой страницы, чтобы на ней были собраны вообще все-все курсы, у нас нет. Мы сторонники немного другого подхода, когда курсы собраны в программы — профессии и навыки. Поэтому большинство курсов не отображаются в общем каталоге, так как они находятся внутри определенных программ. Вы можете ознакомиться с содержанием программы в блоке **«Программа обучения»/«Программа курса»** на её странице: там будет отображен полный список тем. diff --git a/docs/faq/hochu-popast-v-hekslet-kolledzh.md b/docs/faq/hochu-popast-v-hekslet-kolledzh.md index 30649436..4825891e 100644 --- a/docs/faq/hochu-popast-v-hekslet-kolledzh.md +++ b/docs/faq/hochu-popast-v-hekslet-kolledzh.md @@ -14,6 +14,6 @@ title: "Хочу попасть в Хекслет Колледж" По всем вопросам, связанным с обучением в Колледже, лучше всего обратиться к их службе поддержки: -**Телефон: 8 (800) 222-75-46** +## Телефон: 8 (800) 222-75-46 -**Email: support@hexly.ru** +## Email: support@hexly.ru diff --git a/docs/faq/kak-aktivirovat-promokod/kak-aktivirovat-promokod.md b/docs/faq/kak-aktivirovat-promokod/kak-aktivirovat-promokod.md index 2bc15288..67506e42 100644 --- a/docs/faq/kak-aktivirovat-promokod/kak-aktivirovat-promokod.md +++ b/docs/faq/kak-aktivirovat-promokod/kak-aktivirovat-promokod.md @@ -14,5 +14,5 @@ title: "Как активировать промокод?" ![](/img/docs/img-050.png) -**Важно:** большинство промокодов Хекслета бессрочные и не привязаны к конкретному аккаунту. Если же вы не уверены в условиях своего промокода, вы всегда +**Важно:** большинство промокодов Хекслета бессрочные и не привязаны к конкретному аккаунту. Если же вы не уверены в условиях своего промокода, вы всегда можете уточнить детали у нашей поддержки по адресу support@hexlet.io — они с радостью помогут вам. diff --git a/docs/faq/kak-izuchat-professii-na-bazovom-plane.md b/docs/faq/kak-izuchat-professii-na-bazovom-plane.md index d022ca8f..bcd6053e 100644 --- a/docs/faq/kak-izuchat-professii-na-bazovom-plane.md +++ b/docs/faq/kak-izuchat-professii-na-bazovom-plane.md @@ -16,4 +16,4 @@ title: "Как изучать профессии на Базовом плане? Чтобы начать проходить профессию на Базовом плане, оформите «Базовый план» на этой странице: https://ru.hexlet.io/subscription -После этого вы сможете вступить в нужную программу через раздел «[Профессии](https://ru.hexlet.io/my/catalog/professions)» в личном кабинете и приступить к изучению — активная профессия будет отображаться на странице «[Дашборд](https://ru.hexlet.io/my)». \ No newline at end of file +После этого вы сможете вступить в нужную программу через раздел «[Профессии](https://ru.hexlet.io/my/catalog/professions)» в личном кабинете и приступить к изучению — активная профессия будет отображаться на странице «[Дашборд](https://ru.hexlet.io/my)». diff --git a/docs/faq/kak-otmenit-podpisku/kak-otmenit-podpisku.md b/docs/faq/kak-otmenit-podpisku/kak-otmenit-podpisku.md index cc86643a..45d27571 100644 --- a/docs/faq/kak-otmenit-podpisku/kak-otmenit-podpisku.md +++ b/docs/faq/kak-otmenit-podpisku/kak-otmenit-podpisku.md @@ -10,7 +10,7 @@ title: "Как отменить подписку?" ## Базовый план -Отменить подписку на «**Базовый план**» можно в любой удобный момент в разделе «**[Оплата](https://ru.hexlet.io/account/subscription)**». Обратите внимание, что подписка +Отменить подписку на «**Базовый план**» можно в любой удобный момент в разделе «**[Оплата](https://ru.hexlet.io/account/subscription)**». Обратите внимание, что подписка оформляется с автопродлением, поэтому важно следить за сроками. Для вашего удобства платежная система дополнительно отправляет уведомление на почту за три дня до списания средств. @@ -25,6 +25,6 @@ title: "Как отменить подписку?" Вам нужно уведомить вашего куратора, что вы хотите отменить подписку, ребята отменят ее в кратчайшие сроки. -Также вы можете написать в поддержку **support@hexlet.io** — ребята оперативно помогут. +Также вы можете написать в поддержку support@hexlet.io — ребята оперативно помогут. **После того, как вы отмените подписку и закончится оплаченный период, данные вашей карты будут удалены.** diff --git a/docs/faq/kak-otpisatsya-ot-rassylki-heksleta/kak-otpisatsya-ot-rassylki-heksleta.md b/docs/faq/kak-otpisatsya-ot-rassylki-heksleta/kak-otpisatsya-ot-rassylki-heksleta.md index f2c5c2b1..f2ef585e 100644 --- a/docs/faq/kak-otpisatsya-ot-rassylki-heksleta/kak-otpisatsya-ot-rassylki-heksleta.md +++ b/docs/faq/kak-otpisatsya-ot-rassylki-heksleta/kak-otpisatsya-ot-rassylki-heksleta.md @@ -8,10 +8,10 @@ title: "Как отписаться от рассылки Хекслета?" > Если вы не хотите получать наши письма. -Рассылка — важный способ держать студентов Хекслета в курсе всех новостей и полезной информации. Мы стараемся делиться только тем, +Рассылка — важный способ держать студентов Хекслета в курсе всех новостей и полезной информации. Мы стараемся делиться только тем, что действительно интересно и важно! -Если вы решите больше не получать письма, отписаться можно в любой момент. В каждом письме в самом низу есть ссылка «**отписаться**» — +Если вы решите больше не получать письма, отписаться можно в любой момент. В каждом письме в самом низу есть ссылка «**отписаться**» — если кликнуть по ней, вы больше не будете получать рассылку. ![](/img/docs/img-052.png) diff --git a/docs/faq/kak-pomenyat-yazyk-na-saite/kak-pomenyat-yazyk-na-saite.md b/docs/faq/kak-pomenyat-yazyk-na-saite/kak-pomenyat-yazyk-na-saite.md index e2a55e3a..0de2ffc6 100644 --- a/docs/faq/kak-pomenyat-yazyk-na-saite/kak-pomenyat-yazyk-na-saite.md +++ b/docs/faq/kak-pomenyat-yazyk-na-saite/kak-pomenyat-yazyk-na-saite.md @@ -12,7 +12,7 @@ title: "Как поменять язык на сайте?" ![](/img/docs/img-053.png) -**Важный момент** +## Важный момент -После смены языка у вас изменится прогресс в вашем профиле. Это нормально: материалы на разных языках отличаются, поэтому мы считаем прогресс +После смены языка у вас изменится прогресс в вашем профиле. Это нормально: материалы на разных языках отличаются, поэтому мы считаем прогресс отдельно для каждой языковой версии. diff --git a/docs/faq/kuda-propal-moi-kod/kuda-propal-moi-kod.md b/docs/faq/kuda-propal-moi-kod/kuda-propal-moi-kod.md index 1caafee2..83b469ca 100644 --- a/docs/faq/kuda-propal-moi-kod/kuda-propal-moi-kod.md +++ b/docs/faq/kuda-propal-moi-kod/kuda-propal-moi-kod.md @@ -8,10 +8,10 @@ title: "Куда пропал мой код?" > Описываем, почему важно сохранять решения в практиках. -Если после прохождения урока долго не заходить в тренажёр, ваше решение может перестать отображаться в нём. При этом отметка о прохождении урока +Если после прохождения урока долго не заходить в тренажёр, ваше решение может перестать отображаться в нём. При этом отметка о прохождении урока сохранится, если задание было выполнено успешно. -Восстановить «пропавшее» решение невозможно. Чтобы избежать потери, вы можете заранее **[сохранить его](/docs/practice/kak-sohranit-svoe-reshenie.md)** во время прохождения практики — тогда оно +Восстановить «пропавшее» решение невозможно. Чтобы избежать потери, вы можете заранее **[сохранить его](/docs/practice/kak-sohranit-svoe-reshenie.md)** во время прохождения практики — тогда оно навсегда останется в вашем аккаунте. ![](/img/docs/img-054.png) diff --git a/docs/faq/ne-poluchaetsya-vosstanovit-parol/ne-poluchaetsya-vosstanovit-parol.md b/docs/faq/ne-poluchaetsya-vosstanovit-parol/ne-poluchaetsya-vosstanovit-parol.md index 7fdce6a3..39e4af41 100644 --- a/docs/faq/ne-poluchaetsya-vosstanovit-parol/ne-poluchaetsya-vosstanovit-parol.md +++ b/docs/faq/ne-poluchaetsya-vosstanovit-parol/ne-poluchaetsya-vosstanovit-parol.md @@ -24,6 +24,5 @@ title: "Не получается восстановить пароль" **Причина:** ваша почтовая служба заблокировала наши письма, так как наши предыдущие уведомления могли быть помечены как спам. **Что нужно сделать:** найдите наши письма в папке «**Спам**» и верните их во «**Входящие**». - Сообщите нам на support@hexlet.io — мы сразу же предпримем действия по разблокировке. Это восстановит доставку наших уведомлений, + Сообщите нам на support@hexlet.io — мы сразу же предпримем действия по разблокировке. Это восстановит доставку наших уведомлений, и вы сможете беспрепятственно получать все необходимые письма. - diff --git a/docs/faq/nuzhna-pomoshch-cheloveka.md b/docs/faq/nuzhna-pomoshch-cheloveka.md index 9c49c22f..73176123 100644 --- a/docs/faq/nuzhna-pomoshch-cheloveka.md +++ b/docs/faq/nuzhna-pomoshch-cheloveka.md @@ -8,7 +8,7 @@ title: "Нужна помощь человека" > Перечисляем случаи, когда вам может понадобиться помощь поддержки, куратора или консультанта. Случаи не касаются помощи в учебных материалах. -## Если вы учитесь на тарифе «Оптимальный» или «Премиальный» и у вас возник вопрос: +## Если вы учитесь на тарифе «Оптимальный» или «Премиальный» и у вас возник вопрос 1. Академический отпуск 2. Продление обучения @@ -22,12 +22,12 @@ title: "Нужна помощь человека" ## Если вы новичок и вам нужна консультация -Будь то ваши первые шаги в IT или желание освоить новую профессию с опытом за плечами — вы всегда можете обратиться за бесплатной -консультацией к нашим специалистам. +Будь то ваши первые шаги в IT или желание освоить новую профессию с опытом за плечами — вы всегда можете обратиться за бесплатной +консультацией к нашим специалистам. -Просто оставьте заявку на странице интересующей профессии, и мы свяжемся с вами в течение дня. -Если удобнее, пишите нам в Telegram: @hexlet_edu — консультанты отвечают не только в будни, но и в выходные, чтобы вы могли -получить консультацию в любой удобный для вас момент. +Просто оставьте заявку на странице интересующей профессии, и мы свяжемся с вами в течение дня. +Если удобнее, пишите нам в Telegram: @hexlet_edu — консультанты отвечают не только в будни, но и в выходные, чтобы вы могли +получить консультацию в любой удобный для вас момент. ## А что насчет поддержки @@ -38,5 +38,6 @@ title: "Нужна помощь человека" Работают ребята по будням с 10:00 до 19:00 по МСК. Если вы написали в выходные, ответ придёт уже в понедельник. **Контакты службы поддержки:** + - почта support@hexlet.io - телеграм @hexlet_help_bot diff --git a/docs/faq/pochemu-u-menya-propal-progress/pochemu-u-menya-propal-progress.md b/docs/faq/pochemu-u-menya-propal-progress/pochemu-u-menya-propal-progress.md index ce5bc5a4..114fb498 100644 --- a/docs/faq/pochemu-u-menya-propal-progress/pochemu-u-menya-propal-progress.md +++ b/docs/faq/pochemu-u-menya-propal-progress/pochemu-u-menya-propal-progress.md @@ -12,22 +12,22 @@ title: "Почему у меня пропал прогресс?" ## Вы зашли не в тот профиль -Чаще всего пропажа прогресса происходит из-за того, что пользователь заходит в систему с другой почтой. Например, -случайно была выбрана авторизация через VK или Яндекс ID, и в результате может появиться новый профиль. +Чаще всего пропажа прогресса происходит из-за того, что пользователь заходит в систему с другой почтой. Например, +случайно была выбрана авторизация через VK или Яндекс ID, и в результате может появиться новый профиль. -В таком случае нужно войти в тот профиль, на котором вы действительно обучались, а случайно созданный — удалить. По правилам +В таком случае нужно войти в тот профиль, на котором вы действительно обучались, а случайно созданный — удалить. По правилам Хекслета каждый пользователь может иметь только один профиль. ![](/img/docs/img-056.png) ## Вы зашли в другую локаль -Прогресс в русской и английской версиях Хекслета ведётся отдельно. Поэтому, если вы случайно переключились на другую локаль, -может показаться, что все пройденные материалы исчезли. Не волнуйтесь — просто поменяйте язык в футере сайта, и весь ваш прогресс +Прогресс в русской и английской версиях Хекслета ведётся отдельно. Поэтому, если вы случайно переключились на другую локаль, +может показаться, что все пройденные материалы исчезли. Не волнуйтесь — просто поменяйте язык в футере сайта, и весь ваш прогресс снова окажется на месте :) ## Курс был удален или изменен -Наша техническая команда активно работает над улучшением материалов, поэтому может случиться так, что в курсе будут удалены -пройденные вами материалы, или курс вовсе будет удален (хотя такое случается очень редко). Вы можете уточнить этот момент у +Наша техническая команда активно работает над улучшением материалов, поэтому может случиться так, что в курсе будут удалены +пройденные вами материалы, или курс вовсе будет удален (хотя такое случается очень редко). Вы можете уточнить этот момент у нашей поддержки по почте support@hexlet.io, и ребята подскажут, что случилось с интересующим вас курсом. diff --git a/docs/faq/u-vas-est-garantiya-trudoustroistva.md b/docs/faq/u-vas-est-garantiya-trudoustroistva.md index 405d1a33..6c1223fc 100644 --- a/docs/faq/u-vas-est-garantiya-trudoustroistva.md +++ b/docs/faq/u-vas-est-garantiya-trudoustroistva.md @@ -8,18 +8,18 @@ title: "У вас есть гарантия трудоустройства?" > Краткая информация о том, как мы помогаем найти работу. -У нас есть полноценный проект **Хекслет.Карьера**, посвящённый помощи студентам в трудоустройстве. К нему подключаются ближе к концу обучения, когда уже +У нас есть полноценный проект **Хекслет.Карьера**, посвящённый помощи студентам в трудоустройстве. К нему подключаются ближе к концу обучения, когда уже есть необходимые знания и навыки. -В рамках проекта мы поддерживаем студентов на каждом этапе поиска работы: через живое сообщество, тестовые собеседования, доступ к партнерским вакансиям и +В рамках проекта мы поддерживаем студентов на каждом этапе поиска работы: через живое сообщество, тестовые собеседования, доступ к партнерским вакансиям и множество других инструментов, которые помогают достичь карьерных целей. -Кроме того, участники **Хекслет.Карьеры** получают практический опыт в коммерческих проектах и проходят собеседования в компаниях-партнёрах для стажировок и +Кроме того, участники **Хекслет.Карьеры** получают практический опыт в коммерческих проектах и проходят собеседования в компаниях-партнёрах для стажировок и последующего трудоустройства. Подробнее о проекте можно узнать здесь: https://career.hexlet.io/ -Гарантия трудоустройства регулируется акцией «**Вернём деньги, если не получилось найти работу**». Мы гарантируем успешное трудоустройство при условии, +Гарантия трудоустройства регулируется акцией «**Вернём деньги, если не получилось найти работу**». Мы гарантируем успешное трудоустройство при условии, что студент следует всем рекомендациям нашей команды. Страница акции: https://ru.hexlet.io/pages/money_back_not_hired_2025 diff --git a/docs/faq/u-vas-est-temnaya-tema/u-vas-est-temnaya-tema.md b/docs/faq/u-vas-est-temnaya-tema/u-vas-est-temnaya-tema.md index 0742670e..7b3230f9 100644 --- a/docs/faq/u-vas-est-temnaya-tema/u-vas-est-temnaya-tema.md +++ b/docs/faq/u-vas-est-temnaya-tema/u-vas-est-temnaya-tema.md @@ -8,11 +8,11 @@ title: "У вас есть темная тема?" > Показываем, как включить эту функцию. -Мы понимаем, что яркий светлый фон может утомлять глаза при долгой работе на платформе или просто визуально не нравиться. Поэтому наша техническая +Мы понимаем, что яркий светлый фон может утомлять глаза при долгой работе на платформе или просто визуально не нравиться. Поэтому наша техническая команда добавила возможность переключаться на **темную тему**. Вы можете включить её, нажав на иконку «Луны» справа сверху возле иконки профиля. ![](/img/docs/img-058.png) -Если вы заметите баги или хотите предложить улучшения для темной темы, отправляйте их с помощью **Ctrl+Enter**. \ No newline at end of file +Если вы заметите баги или хотите предложить улучшения для темной темы, отправляйте их с помощью **Ctrl+Enter**. diff --git a/docs/faq/v-hekslete-est-vozmozhnost-poluchit-diplom.md b/docs/faq/v-hekslete-est-vozmozhnost-poluchit-diplom.md index e8cc0b0c..cb802403 100644 --- a/docs/faq/v-hekslete-est-vozmozhnost-poluchit-diplom.md +++ b/docs/faq/v-hekslete-est-vozmozhnost-poluchit-diplom.md @@ -8,7 +8,7 @@ title: "В Хекслете есть возможность получить д > Рассказываем, что можно получить помимо сертификата о завершении. -У Хекслета есть лицензия на осуществление образовательной деятельности, что позволяет нам выдавать выпускникам +У Хекслета есть лицензия на осуществление образовательной деятельности, что позволяет нам выдавать выпускникам **дипломы о профессиональной переподготовке (ДПО)**. ## Условия получения диплома diff --git a/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md b/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md index 69f07814..b9456e37 100644 --- a/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md +++ b/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md @@ -10,7 +10,7 @@ title: "Я могу иметь больше одного аккаунта?" ## Один пользователь — один аккаунт -Согласно [условиям использования платформы](https://ru.hexlet.io/pages/tos), каждый пользователь может иметь только один аккаунт. Это правило действует и в тех случаях, +Согласно [условиям использования платформы](https://ru.hexlet.io/pages/tos), каждый пользователь может иметь только один аккаунт. Это правило действует и в тех случаях, когда несколько человек хотят обучаться, используя одну учётную запись: у каждого студента должен быть свой личный аккаунт. Удалить лишние аккаунты всегда можно в настройках в этом разделе: https://ru.hexlet.io/account/settings/edit diff --git a/docs/finance-and-payments/kak-oformit-vozvrat.md b/docs/finance-and-payments/kak-oformit-vozvrat.md index f55c7618..d520dbee 100644 --- a/docs/finance-and-payments/kak-oformit-vozvrat.md +++ b/docs/finance-and-payments/kak-oformit-vozvrat.md @@ -42,4 +42,4 @@ title: "Как оформить возврат?" Также можно оформить возврат всей уплаченной суммы, если с момента оплаты программы прошло **менее 14 дней**. -Если нужно оформить возврат или задать вопросы, связанные с ним, напишите вашему куратору или в поддержку на почту [support@hexlet.io](mailto:support@hexlet.io) — поможем во всём разобраться. \ No newline at end of file +Если нужно оформить возврат или задать вопросы, связанные с ним, напишите вашему куратору или в поддержку на почту [support@hexlet.io](mailto:support@hexlet.io) — поможем во всём разобраться. diff --git a/docs/finance-and-payments/kak-podarit-obuchenie-drugu/kak-podarit-obuchenie-drugu.md b/docs/finance-and-payments/kak-podarit-obuchenie-drugu/kak-podarit-obuchenie-drugu.md index 3ab673ff..abc52c74 100644 --- a/docs/finance-and-payments/kak-podarit-obuchenie-drugu/kak-podarit-obuchenie-drugu.md +++ b/docs/finance-and-payments/kak-podarit-obuchenie-drugu/kak-podarit-obuchenie-drugu.md @@ -26,4 +26,4 @@ title: "Как подарить обучение другу" ## Обучение с наставником -На странице с сертификатами пока нельзя оплатить обучение с наставником. Если хотите сделать такой подарок, напишите на support@hexlet.io — мы поможем всё оформить. \ No newline at end of file +На странице с сертификатами пока нельзя оплатить обучение с наставником. Если хотите сделать такой подарок, напишите на support@hexlet.io — мы поможем всё оформить. diff --git a/docs/finance-and-payments/pauza-vo-vremya-obucheniya.md b/docs/finance-and-payments/pauza-vo-vremya-obucheniya.md index 607165dc..a142ff64 100644 --- a/docs/finance-and-payments/pauza-vo-vremya-obucheniya.md +++ b/docs/finance-and-payments/pauza-vo-vremya-obucheniya.md @@ -12,8 +12,8 @@ title: "Пауза во время обучения" Есть два варианта: -* **Если перерыв небольшой, до недели**: так как жёсткий дедлайн только один — в конце обучения, вы можете учиться в своём темпе и делать перерывы, когда нужно. Курсы и проекты доступны на сайте круглосуточно, а вебинары и активности, которые проводит наставник, мы всегда сохраняем. -* **Перерыв больше недели:** предупредите вашего куратора или напишите в поддержку на почту support@hexlet.io. Возобновить обучение можно будет с того же этапа, прогресс сохранится. Если обучение оплачивается в рассрочку, платежи продолжатся по тому же графику, несмотря на приостановку обучения. +- **Если перерыв небольшой, до недели**: так как жёсткий дедлайн только один — в конце обучения, вы можете учиться в своём темпе и делать перерывы, когда нужно. Курсы и проекты доступны на сайте круглосуточно, а вебинары и активности, которые проводит наставник, мы всегда сохраняем. +- **Перерыв больше недели:** предупредите вашего куратора или напишите в поддержку на почту support@hexlet.io. Возобновить обучение можно будет с того же этапа, прогресс сохранится. Если обучение оплачивается в рассрочку, платежи продолжатся по тому же графику, несмотря на приостановку обучения. Важный момент: во время академического отпуска доступ к платформе закрывается, поэтому изучать материалы не получится. В [этой статье](/docs/learning-process/akademicheskii-otpusk.md) мы рассказали подробнее об академическом отпуске. diff --git a/docs/finance-and-payments/skidki.md b/docs/finance-and-payments/skidki.md index 32a28838..15e51a76 100644 --- a/docs/finance-and-payments/skidki.md +++ b/docs/finance-and-payments/skidki.md @@ -21,7 +21,7 @@ title: "Скидки" - За отзыв о Хекслете можно получить дни доступа по Базовому плану, либо продление Оптимального/Премиального тарифа, если вы уже учитесь на них. Подробные условия [здесь](/docs/site-and-platform/bonusy-za-otzyvy/delites_otzyvami_i_poluchayte_bonusy.md). - Оплатите сразу весь срок обучения по программе. Это дешевле, чем платить помесячно. - + - Скидки для людей с инвалидностью: - - можно учиться самостоятельно на Базовом плане бесплатно в течение полугода; - - на тарифы Оптимальный и Премиальный скидка 50% от полной стоимости (зачеркнутая цена) на все программы, кроме «Инженер по ручному тестированию» и «Разработчик на Ruby on Rails». Подробные условия и актуальность скидки можно уточнить в нашей службе поддержки support@hexlet.io. + - можно учиться самостоятельно на Базовом плане бесплатно в течение полугода; + - на тарифы Оптимальный и Премиальный скидка 50% от полной стоимости (зачеркнутая цена) на все программы, кроме «Инженер по ручному тестированию» и «Разработчик на Ruby on Rails». Подробные условия и актуальность скидки можно уточнить в нашей службе поддержки support@hexlet.io. diff --git a/docs/finance-and-payments/sposoby-oplaty.md b/docs/finance-and-payments/sposoby-oplaty.md index 28a67c9b..4b172a4c 100644 --- a/docs/finance-and-payments/sposoby-oplaty.md +++ b/docs/finance-and-payments/sposoby-oplaty.md @@ -8,7 +8,6 @@ title: "Способы оплаты" Мы принимаем банковские карты Visa, MasterCard, American Express и МИР, в том числе виртуальные. Также возможна оплата виртуальными картами систем электронных денег, таких как [WebMoney](https://cards.web.money/). - ## Частями при помощи Яндекс Сплит При оплате заказа со Сплитом сумма делится на части. Первый платеж спишется сразу, остальные — по [графику](https://yandex.ru/support2/split/ru/conditions), который вы увидите при оформлении. Заказ отправится к вам после первого платежа. @@ -38,14 +37,14 @@ title: "Способы оплаты" ### Условия -**Рассрочка** +#### Рассрочка - Срок рассрочки — от 6 до 24 месяцев - Первый взнос — 0 руб. - Переплата — 0 руб. - Сумма рассрочки от 3 000 до 1 000 000 руб. -**Кредит** +#### Кредит - Срок кредита — от 3 до 60 месяцев - Первый взнос — 0 руб. @@ -64,10 +63,10 @@ title: "Способы оплаты" - Срок рассрочки — от 6 до 24 месяцев -Рассрочка — это форма кредита (займа), при которой переплаты по кредиту (займу) не возникает за счет скидки на товар, предоставляемой продавцом. Процентная ставка по продукту «Рассрочка» — от 0% до 87% годовых. Минимальная сумма — 3 000 руб., максимальная сумма — 500 000 руб. Срок предоставления — от 3 до 36 месяцев. Ваш тариф и размер ежемесячного платежа будут определены по результатам рассмотрения заявки. Подробнее на сайте https://www.tinkoff.ru +Рассрочка — это форма кредита (займа), при которой переплаты по кредиту (займу) не возникает за счет скидки на товар, предоставляемой продавцом. Процентная ставка по продукту «Рассрочка» — от 0% до 87% годовых. Минимальная сумма — 3 000 руб., максимальная сумма — 500 000 руб. Срок предоставления — от 3 до 36 месяцев. Ваш тариф и размер ежемесячного платежа будут определены по результатам рассмотрения заявки. Подробнее на сайте https://www.tinkoff.ru АО «Тинькофф Банк», ООО «Микрофинансовая компания «Т-Финанс». -**Т-банк Кредит Брокер** +#### Т-банк Кредит Брокер Для покупки необходимы: @@ -75,7 +74,7 @@ title: "Способы оплаты" - Постоянный доход - Российский номер мобильного телефона -### Условия +##### Условия - Срок рассрочки — от 6 до 24 месяцев diff --git a/docs/formats-and-tarifs/formats/asinhronnyi-format.md b/docs/formats-and-tarifs/formats/asinhronnyi-format.md index 9a48e58f..2cab6de3 100644 --- a/docs/formats-and-tarifs/formats/asinhronnyi-format.md +++ b/docs/formats-and-tarifs/formats/asinhronnyi-format.md @@ -14,7 +14,7 @@ title: "Асинхронный формат" У каждого курса есть определенная продолжительность, и пройти программу нужно в течение этого срока. При этом не нужно подстраиваться под чёткое расписание: можно заниматься в удобное время, делать паузы и возвращаться к материалам, когда это удобно, главное — уложиться в установленный срок. -О том, как распределить нагрузку и выбрать подходящий темп обучения, рассказываем в отдельной статье: **[Сроки обучения](docs/learning-process/sroki-obucheniya/sroki-obucheniya.md)**. +О том, как распределить нагрузку и выбрать подходящий темп обучения, рассказываем в отдельной статье: **[Сроки обучения](../../learning-process/sroki-obucheniya/sroki-obucheniya.md)**. Программа включает теорию, тесты, упражнения, испытания и проекты. @@ -30,4 +30,4 @@ title: "Асинхронный формат" **[Наставник](/docs/learning-process/nastavnik.md)** помогает с учебными вопросами: разбирает сложные темы, отвечает на вопросы по программе и подсказывает, как двигаться дальше, если не получается найти решение. -После выполнения последнего проекта программы студентам предлагается присоединиться к [Хекслет.Карьере](/docs/career/hekslet-karera.md) для подготовки к трудоустройству. \ No newline at end of file +После выполнения последнего проекта программы студентам предлагается присоединиться к [Хекслет.Карьере](/docs/career/hekslet-karera.md) для подготовки к трудоустройству. diff --git a/docs/formats-and-tarifs/formats/sinhronnyi-format.md b/docs/formats-and-tarifs/formats/sinhronnyi-format.md index 5e05387b..901891f3 100644 --- a/docs/formats-and-tarifs/formats/sinhronnyi-format.md +++ b/docs/formats-and-tarifs/formats/sinhronnyi-format.md @@ -24,6 +24,6 @@ title: "Синхронный формат" Для удобства общения между студентами и поддержки в организационных вопросах мы создаем закрытые **учебные чаты с куратором и наставником** для оперативной помощи с вопросами по урокам. -[**Куратор**](/docs/learning-process/kurator.md) отвечает за учебный процесс и помогает студентам на всех этапах обучения по организационным моментам. Если возникают трудности, куратору всегда можно написать — он подскажет, как действовать дальше. +[**Куратор**](/docs/learning-process/kurator.md) отвечает за учебный процесс и помогает студентам на всех этапах обучения по организационным моментам. Если возникают трудности, куратору всегда можно написать — он подскажет, как действовать дальше. -[**Наставник**](/docs/learning-process/nastavnik.md) помогает с учебными вопросами: проводит онлайн-занятия, разбирает сложные темы, отвечает на вопросы по программе и подсказывает, как двигаться дальше, если не получается найти решение. \ No newline at end of file +[**Наставник**](/docs/learning-process/nastavnik.md) помогает с учебными вопросами: проводит онлайн-занятия, разбирает сложные темы, отвечает на вопросы по программе и подсказывает, как двигаться дальше, если не получается найти решение. diff --git a/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-gruppovoi-prodvinutyi.md b/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-gruppovoi-prodvinutyi.md index 8e285891..bf53df28 100644 --- a/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-gruppovoi-prodvinutyi.md +++ b/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-gruppovoi-prodvinutyi.md @@ -8,24 +8,24 @@ title: "Тариф Групповой (Продвинутый)" Архивный тариф -*Внимание! Этот тариф находится в архиве с 18 февраля 2025 года и остается доступным только для студентов, которые уже его приобрели.* +_Внимание! Этот тариф находится в архиве с 18 февраля 2025 года и остается доступным только для студентов, которые уже его приобрели._ Один из тарифов обучения в Хекслете — Групповой. Обучаясь на этом тарифе, студенты [изучают программы](https://ru.hexlet.io/courses) профессий с поддержкой наставника и куратора. -# Преимущества +## Преимущества -* Помощь [наставника](/docs/learning-process/nastavnik.md) в ходе всего обучения. Каждый наставник — практикующий программист, который не только помогает освоить курс, но и делится своим опытом. -* Помощь [куратора](/docs/learning-process/kurator.md) во всех организационных вопросах. -* Поддержка и общение в чате с другими студентами, изучающими эту же профессию. -* Практические проекты. В ходе обучения студенты разрабатывают полноценные приложения или верстают страницы и публикуют их код на GitHub — создают своё портфолио, которое поможет быстрее найти работу. -* Закрытые вебинары внутри группы. Наставники отвечают на вопросы, разбирают сложные моменты, рассказывают об актуальных технологиях и инструментах. -* Участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md) для помощи с трудоустройством. -* Практика в коммерческих проектах Хекслета. Погружение в реальные задачи сразу после обучения. -* Сертификат Хекслета. Получить наш сертификат непросто, поэтому его ценят работодатели. -* Академический отпуск на 1 месяц. Во время обучения можно будет сделать перерыв без потери оплаченного времени обучения. -* Бессрочный доступ к теории пройденных уроков и [сохраненным решениям](/docs/practice/kak-sohranit-svoe-reshenie.md). После завершения обучения всегда можно будет повторить теоретическую часть пройденных материалов. Доступ к теории сохранится навсегда при условии, что урок был пройден полностью: с теоретической частью, упражнениями и тестами, если они есть. +- Помощь [наставника](/docs/learning-process/nastavnik.md) в ходе всего обучения. Каждый наставник — практикующий программист, который не только помогает освоить курс, но и делится своим опытом. +- Помощь [куратора](/docs/learning-process/kurator.md) во всех организационных вопросах. +- Поддержка и общение в чате с другими студентами, изучающими эту же профессию. +- Практические проекты. В ходе обучения студенты разрабатывают полноценные приложения или верстают страницы и публикуют их код на GitHub — создают своё портфолио, которое поможет быстрее найти работу. +- Закрытые вебинары внутри группы. Наставники отвечают на вопросы, разбирают сложные моменты, рассказывают об актуальных технологиях и инструментах. +- Участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md) для помощи с трудоустройством. +- Практика в коммерческих проектах Хекслета. Погружение в реальные задачи сразу после обучения. +- Сертификат Хекслета. Получить наш сертификат непросто, поэтому его ценят работодатели. +- Академический отпуск на 1 месяц. Во время обучения можно будет сделать перерыв без потери оплаченного времени обучения. +- Бессрочный доступ к теории пройденных уроков и [сохраненным решениям](/docs/practice/kak-sohranit-svoe-reshenie.md). После завершения обучения всегда можно будет повторить теоретическую часть пройденных материалов. Доступ к теории сохранится навсегда при условии, что урок был пройден полностью: с теоретической частью, упражнениями и тестами, если они есть. -# Как организовано обучение +## Как организовано обучение Основа программы — это уроки и проекты по выбранной профессии. @@ -39,7 +39,7 @@ title: "Тариф Групповой (Продвинутый)" После начала работы над последним учебным проектом программы студентам предлагается присоединиться к [Хекслет.Карьере](/docs/career/hekslet-karera.md) для подготовки к трудоустройству. -# Срок обучения и оплата +## Срок обучения и оплата Общий срок обучения и стоимость зависит от конкретной программы. diff --git a/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-standartnyi-old.md b/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-standartnyi-old.md index f7d9bce2..b4de5afb 100644 --- a/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-standartnyi-old.md +++ b/docs/formats-and-tarifs/tarifs/archived-tarifs/tarif-standartnyi-old.md @@ -12,12 +12,12 @@ title: "Тариф Стандартный (Архивный)" ## Преимущества -* Практические проекты. В ходе обучения студенты разрабатывают полноценные приложения или верстают страницы и публикуют их код на GitHub — создают своё портфолио, которое поможет быстрее найти работу. -* Ревью проектов [наставником](/docs/learning-process/nastavnik.md). После успешного прохождения автоматической проверки подключится опытный разработчик и проведет ревью. -* [Сертификат](/docs/getting-started/sertifikat/sertifikat.md) Хекслета о прохождении программы. -* Помощь [куратора](/docs/learning-process/kurator.md) со всеми организационными моментами. -* Академический отпуск на 1 месяц. Во время обучения можно будет сделать перерыв без потери оплаченного времени обучения. -* Бессрочный доступ к теории уроков и [сохранённым решениям](/docs/practice/kak-sohranit-svoe-reshenie.md). После завершения обучения всегда можно будет повторить теоретическую часть программы. +- Практические проекты. В ходе обучения студенты разрабатывают полноценные приложения или верстают страницы и публикуют их код на GitHub — создают своё портфолио, которое поможет быстрее найти работу. +- Ревью проектов [наставником](/docs/learning-process/nastavnik.md). После успешного прохождения автоматической проверки подключится опытный разработчик и проведет ревью. +- [Сертификат](/docs/getting-started/sertifikat/sertifikat.md) Хекслета о прохождении программы. +- Помощь [куратора](/docs/learning-process/kurator.md) со всеми организационными моментами. +- Академический отпуск на 1 месяц. Во время обучения можно будет сделать перерыв без потери оплаченного времени обучения. +- Бессрочный доступ к теории уроков и [сохранённым решениям](/docs/practice/kak-sohranit-svoe-reshenie.md). После завершения обучения всегда можно будет повторить теоретическую часть программы. ## Как организовано обучение diff --git a/docs/formats-and-tarifs/tarifs/bazovyi-plan.md b/docs/formats-and-tarifs/tarifs/bazovyi-plan.md index e50df817..ac8c85a1 100644 --- a/docs/formats-and-tarifs/tarifs/bazovyi-plan.md +++ b/docs/formats-and-tarifs/tarifs/bazovyi-plan.md @@ -14,7 +14,7 @@ title: "Базовый план" - **На трехлетнем плане** доступны будут все программы профессий Хекслета, все навыки и отдельные курсы. Внутри профессий, навыков и отдельных курсов откроются все материалы на платформе: уроки (теория, тесты, упражнения), проекты, испытания, самостоятельные работы и так далее. - **На ежемесячном и ежегодном плане** будут доступны все курсы из раздела [Подписка](https://ru.hexlet.io/courses_subscription). В эти планы не входят новые профессии, к которым относятся Go-разработчик (с нуля и для продвинутых), DevOps-инженер с нуля, курсы по ИИ. + **На ежемесячном и ежегодном плане** будут доступны все курсы из раздела [Подписка](https://ru.hexlet.io/courses_subscription). В эти планы не входят новые профессии, к которым относятся Go-разработчик (с нуля и для продвинутых), DevOps-инженер с нуля, курсы по ИИ. - Пожизненный доступ к теории пройденных уроков. Удобно, если решите повторить изученное после окончания подписки. Доступ к теории пройденных уроков сохранится навсегда при условии, что урок пройден полностью: с теоретической частью, упражнениями и тестами, если они есть. @@ -58,4 +58,4 @@ title: "Базовый план" ## Я не хочу оформлять подписку -Если формат подписки для вас не очень удобен, а желание получить доступ к платформе есть, то вы можете написать нам в поддержку support@hexlet.io. Ребята подскажут, какие варианты ещё есть :) \ No newline at end of file +Если формат подписки для вас не очень удобен, а желание получить доступ к платформе есть, то вы можете написать нам в поддержку support@hexlet.io. Ребята подскажут, какие варианты ещё есть :) diff --git a/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md b/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md index d5f76ca6..916beda3 100644 --- a/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md +++ b/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md @@ -12,7 +12,7 @@ title: "Тариф Оптимальный" ## Возможности тарифа -### Для обучения: +### Для обучения - **Помощь [наставников](/docs/learning-process/nastavnik.md)** на протяжении всего прохождения программы. Каждый наставник — опытный разработчик, который своевременно помогает разобраться с неочевидными моментами в уроках и проектах. На этом тарифе оперативная помощь наставника по урокам доступна в учебном чате в Telegram. @@ -30,7 +30,7 @@ title: "Тариф Оптимальный" - **Бессрочный доступ к теории уроков и [сохранённым решениям](/docs/practice/kak-sohranit-svoe-reshenie.md).** После завершения обучения всегда можно будет повторить теоретическую часть программы. -### Для помощи с трудоустройством доступно участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md): +### Для помощи с трудоустройством доступно участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md) - Доступ в закрытое Telegram-сообщество «Хекслет.Карьера» на 6 месяцев — обмен опытом, истории успеха, обсуждение рынка труда, поддержка от других участников и наших карьерных специалистов. diff --git a/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md b/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md index eaff08bb..086ef307 100644 --- a/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md +++ b/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md @@ -12,7 +12,7 @@ title: "Тариф Премиальный" ## Преимущества -### Для обучения: +### Для обучения - **Помощь [наставника](/docs/learning-process/nastavnik.md)** в ходе всего обучения. Каждый наставник — практикующий разработчик, который не только помогает освоить курс, но и делится своим опытом. @@ -34,7 +34,7 @@ title: "Тариф Премиальный" - **Бессрочный доступ к теории уроков и [сохранённым решениям](/docs/practice/kak-sohranit-svoe-reshenie.md).** После завершения обучения всегда можно будет повторить теоретическую часть программы. -### Для помощи с трудоустройством доступно участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md): +### Для помощи с трудоустройством доступно участие в [Хекслет.Карьере](/docs/career/hekslet-karera.md) - Доступ в закрытое Telegram-сообщество «Хекслет.Карьера» на 6 месяцев — обмен опытом, истории успеха, обсуждение рынка труда, поддержка от других участников и наших карьерных специалистов. diff --git a/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md b/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md index 84c21281..8cac3dce 100644 --- a/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md +++ b/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md @@ -42,4 +42,4 @@ title: "Тариф Расширенный" Чтобы справляться с нагрузкой, рекомендуем выделять от 12 часов в неделю. -Оплатить обучение можно как единым платежом сразу, так и в рассрочку. \ No newline at end of file +Оплатить обучение можно как единым платежом сразу, так и в рассрочку. diff --git a/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md b/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md index 95467809..319efe7f 100644 --- a/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md +++ b/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md @@ -42,4 +42,4 @@ title: "Тариф Стандартный" Чтобы справляться с нагрузкой, рекомендуем выделять от 12 часов в неделю. -Оплатить обучение можно как единым платежом сразу, так и в рассрочку. \ No newline at end of file +Оплатить обучение можно как единым платежом сразу, так и в рассрочку. diff --git a/docs/getting-started/besplatnye-resursy-heksleta.md b/docs/getting-started/besplatnye-resursy-heksleta.md index 45f6b354..b73ec92f 100644 --- a/docs/getting-started/besplatnye-resursy-heksleta.md +++ b/docs/getting-started/besplatnye-resursy-heksleta.md @@ -20,4 +20,3 @@ title: "Бесплатные ресурсы Хекслета" - **Наш блог** — статьи по программированию, истории студентов, новости Хекслета. 🔗 [ru.hexlet.io/blog](https://ru.hexlet.io/blog) - diff --git a/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md b/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md index 0a9aca76..4827b187 100644 --- a/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md +++ b/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md @@ -10,7 +10,7 @@ title: "Как устроены курсы в Хекслете" Курсы состоят из уроков. Каждый урок включает до трёх шагов: теория, тест и упражнение. Теория есть всегда, а тестов или упражнения в некоторых уроках может не быть. -# Теория +## Теория ![](/img/docs/img-062.png) @@ -18,7 +18,7 @@ title: "Как устроены курсы в Хекслете" Когда вы посмотрели видео и прочитали текст, нажимайте на кнопку «Дальше» в правом верхнем углу. Этот шаг урока будет отмечен как завершенный, и вы попадёте на следующий шаг. -# Тест +## Тест ![](/img/docs/img-060.png) @@ -28,7 +28,7 @@ title: "Как устроены курсы в Хекслете" Шаг будет завершён после того, как вы правильно ответите на все вопросы. Перепройти тест можно, нажав на кнопку «Пройти заново» в правой панели. -# Упражнение (Практика) +## Упражнение (Практика) ![](/img/docs/img-061.png) @@ -36,9 +36,9 @@ title: "Как устроены курсы в Хекслете" Ваша задача — написать код, решающий описанную задачу и удовлетворяющий тестам. Иногда задание заключается в выполнении определенных команд в терминале. В описании заголовками выделены названия файлов, в которых нужно реализовывать указанную подзадачу. -* Все файлы, в которых нужно писать код, открываются автоматически при старте упражнения -* Код необходимо писать между маркерами `BEGIN`  и `END` -* Ничего стирать не надо. Лишних файлов в практике нет, и маркеры — это не просто комментарии +- Все файлы, в которых нужно писать код, открываются автоматически при старте упражнения +- Код необходимо писать между маркерами `BEGIN`  и `END` +- Ничего стирать не надо. Лишних файлов в практике нет, и маркеры — это не просто комментарии После выполнения задания нажмите на кнопку со стрелкой в правом верхнем углу экрана. Ваше решение будет проверено автоматическими тестами. Если тесты отработают без ошибок, шаг будет завершён, и система предложит вам двигаться дальше. Результаты работы тестов будут выведены во вкладке `Вывод` в редакторе. diff --git a/docs/getting-started/sertifikat/sertifikat.md b/docs/getting-started/sertifikat/sertifikat.md index 19c296f6..868714e9 100644 --- a/docs/getting-started/sertifikat/sertifikat.md +++ b/docs/getting-started/sertifikat/sertifikat.md @@ -31,4 +31,3 @@ title: "Сертификат" ## Образец ![Пример сертификата на русском языке](/img/docs/img-064.png) - diff --git a/docs/getting-started/sistemnye-trebovaniya.md b/docs/getting-started/sistemnye-trebovaniya.md index 362edfb1..9fd6c71b 100644 --- a/docs/getting-started/sistemnye-trebovaniya.md +++ b/docs/getting-started/sistemnye-trebovaniya.md @@ -12,18 +12,17 @@ title: "Системные требования" В дальнейшем для выполнения домашних заданий и проектов вам понадобится на компьютер установить язык программирования, редактор кода и другой софт. Он не особо требовательный, но мы рекомендуем отталкиваться от таких минимальных требований: -* Рекомендуемые минимальные версии ОС: - + Windows 11 - + MacOS14.0 - + Ubuntu 22.04, либо удобный вам дистрибутив Linux -* Процессор: Intel i3 / AMD Ryzen 3 -* Операционная память: от 8GB +- Рекомендуемые минимальные версии ОС: + - Windows 11 + - MacOS14.0 + - Ubuntu 22.04, либо удобный вам дистрибутив Linux +- Процессор: Intel i3 / AMD Ryzen 3 +- Операционная память: от 8GB Также для комфортного прохождения курсов рекомендуем диагональ экрана не менее 15 дюймов. Теорию можно читать с любого удобного вам устройства (смартфона, планшета), но, чтобы комфортно заниматься программированием в условиях настоящего разработчика, лучше работать именно за компьютером. -# ARM-процессоры +## ARM-процессоры Новые компьютеры Apple с процессорами M1 и новее уже хорошо поддерживают весь софт для разработчиков, их можно использовать. Не получится использовать старые ноутбуки с ARM-процессорами и предустановленной Windows 8 / Windows 10. Они не поддерживают установку стороннего софта, поэтому работать на них локально не получится. Виртуальную машину не запустить и переустановить систему на Linux тоже не получится. - diff --git a/docs/intro.md b/docs/intro.md index 28535a89..0aff539b 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -11,7 +11,8 @@ slug: / Если вы только начинаете учиться или хотите разобраться в возможностях платформы, начните отсюда — ответы на большинство вопросов уже есть в наших статьях. -## Популярные статьи: +## Популярные статьи + - [Как устроены курсы в Хекслете](/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md) - [Про сертификат](/docs/getting-started/sertifikat/sertifikat.md) - [Как сохранить свое решение](/docs/practice/kak-sohranit-svoe-reshenie.md) diff --git a/docs/learning-process/akademicheskii-otpusk.md b/docs/learning-process/akademicheskii-otpusk.md index c5538c6e..6e91c588 100644 --- a/docs/learning-process/akademicheskii-otpusk.md +++ b/docs/learning-process/akademicheskii-otpusk.md @@ -6,7 +6,7 @@ title: "Академический отпуск" > В этой статье мы рассказали о том, как работает академический отпуск в Хекслете и как его оформить. -Когда доступ к программе Хекслета получен единовременной оплатой, кредитом или рассрочкой на обучение, средства продолжают списываться независимо от того, учится студент или нет. Академический отпуск нужен, чтобы пропущенное, но оплаченное **время учёбы не «сгорало»**. +Когда доступ к программе Хекслета получен единовременной оплатой, кредитом или рассрочкой на обучение, средства продолжают списываться независимо от того, учится студент или нет. Академический отпуск нужен, чтобы пропущенное, но оплаченное **время учёбы не «сгорало»**. На подписку по **Базовому плану** академический отпуск не распространяется, её можно в любой момент отменить и подключить позже. @@ -16,7 +16,7 @@ title: "Академический отпуск" ## На какой срок можно взять отпуск? -Общая продолжительность отпуска при обучении на Стандартном, Оптимальном или Премиальном тарифе — **1 месяц**. Распределяйте это время, как вам удобно: берите целиком или разбивайте по неделям. +Общая продолжительность отпуска при обучении на Стандартном, Оптимальном или Премиальном тарифе — **1 месяц**. Распределяйте это время, как вам удобно: берите целиком или разбивайте по неделям. Ваше обучение будет приостановлено на время академического отпуска, при этом сохранится количество оплаченных дней. Неизрасходованные дни отпуска не увеличивают количество оплаченных дней обучения. @@ -33,6 +33,6 @@ title: "Академический отпуск" ## Можно ли учиться во время отпуска? -Некоторые школы дают академический отпуск, чтобы студент догнал одногруппников и/или уложился в дедлайны. В Хекслете же академический отпуск даётся для отдыха или других личных целей. +Некоторые школы дают академический отпуск, чтобы студент догнал одногруппников и/или уложился в дедлайны. В Хекслете же академический отпуск даётся для отдыха или других личных целей. Проходить практику и проекты во время академа не получится, а уже сданные проекты наставником не проверяются, пока вы не вернётесь к обучению. Но у вас будет доступ к пройденной теории на сайте, поэтому можно в свободную минутку вернуться и освежить воспоминания по какой-то теме. diff --git a/docs/learning-process/aktivnosti-pri-obuchenii-s-nastavnikom/aktivnosti-pri-obuchenii-s-nastavnikom.md b/docs/learning-process/aktivnosti-pri-obuchenii-s-nastavnikom/aktivnosti-pri-obuchenii-s-nastavnikom.md index 5e1bdd3b..53fc0a4f 100644 --- a/docs/learning-process/aktivnosti-pri-obuchenii-s-nastavnikom/aktivnosti-pri-obuchenii-s-nastavnikom.md +++ b/docs/learning-process/aktivnosti-pri-obuchenii-s-nastavnikom/aktivnosti-pri-obuchenii-s-nastavnikom.md @@ -8,15 +8,15 @@ title: "Активности при обучении с наставником" > Какие бывают активности и где их искать, если вы обучаетесь на тарифе с поддержкой наставника. -В рамках обучения на «**Оптимальном**» или «**Премиальном**» тарифе каждую неделю проходят встречи с наставником. Это дополнительный контент +В рамках обучения на «**Оптимальном**» или «**Премиальном**» тарифе каждую неделю проходят встречи с наставником. Это дополнительный контент к материалам на платформе и возможность обсудить вопросы по урокам или потренироваться в решении задач. -В этой статье мы расскажем, как устроено расписание активностей, как к ним подключиться, где найти записи встреч и как предлагать +В этой статье мы расскажем, как устроено расписание активностей, как к ним подключиться, где найти записи встреч и как предлагать темы для будущих мероприятий. Вся информация про обучение находится на странице «[Мое обучение](https://ru.hexlet.io/my)». ## Про календарь -Расписание мероприятий отображается на странице «[Календарь](https://ru.hexlet.io/my/calendar)». +Расписание мероприятий отображается на странице «[Календарь](https://ru.hexlet.io/my/calendar)». В календаре указаны дни и время встреч, их темы и форматы, уровень мероприятия и имя наставника. Увидеть подробности о мероприятии можно, нажав на него в календаре. ![](/img/docs/img-065.png) diff --git a/docs/learning-process/kurator.md b/docs/learning-process/kurator.md index bb2177dc..cc1d5515 100644 --- a/docs/learning-process/kurator.md +++ b/docs/learning-process/kurator.md @@ -4,7 +4,6 @@ title: "Куратор" [Перейти на сайт](https://ru.hexlet.io) - # Куратор > Кто это и почему он играет важную роль в обучении студентов? @@ -15,45 +14,45 @@ title: "Куратор" За время обучения студент может взаимодействовать со многими кураторами, потому что кураторы подменяют друг друга на время отпуска или праздников, меняются группами. Но каждый куратор должен соответствовать описанному в статье идеалу. -## Вот что делает куратор: +## Вот что делает куратор -* Знакомится со студентом на старте обучения и сопровождает его до выпускного. -* На старте обучения добавляет в учебный чат и выдаёт доступы к контенту. -* Рассказывает как устроено обучение: как задавать вопросы, какое расписание активностей, что делать при возникновении сложностей. -* Помогает отслеживать прогресс в обучении (как вы двигаетесь по программе, успеваете ли уложиться в срок). -* Контролирует работу наставника — сроки и полноту ответов в чате, качество активностей по технической и содержательной части. -* Как минимум раз в месяц приходит к студенту, чтобы обсудить, как обстоят дела с обучением. -* Оформляет студенту [академический отпуск](/docs/learning-process/akademicheskii-otpusk.md), если есть такая необходимость. +- Знакомится со студентом на старте обучения и сопровождает его до выпускного. +- На старте обучения добавляет в учебный чат и выдаёт доступы к контенту. +- Рассказывает как устроено обучение: как задавать вопросы, какое расписание активностей, что делать при возникновении сложностей. +- Помогает отслеживать прогресс в обучении (как вы двигаетесь по программе, успеваете ли уложиться в срок). +- Контролирует работу наставника — сроки и полноту ответов в чате, качество активностей по технической и содержательной части. +- Как минимум раз в месяц приходит к студенту, чтобы обсудить, как обстоят дела с обучением. +- Оформляет студенту [академический отпуск](/docs/learning-process/akademicheskii-otpusk.md), если есть такая необходимость. В любой момент обучения вы можете обратиться к куратору по любому вопросу, связанному с процессом обучения. -## Когда точно стоит обратиться к куратору: +## Когда точно стоит обратиться к куратору -* Если что-то в процессе обучения вам неочевидно: например, вы не знаете, где и как задавать вопросы по учебным материалам, в каких активностях участвовать и так далее. -* Если вы хотели бы проверить ваш прогресс. -* Если вам нужна [пауза в обучении](/docs/learning-process/akademicheskii-otpusk.md). -* Если учиться сложно и вы не знаете, что с этим делать. -* Если вы не получаете поддержку от наставника. -* Если необходимо сменить программу или формат обучения. +- Если что-то в процессе обучения вам неочевидно: например, вы не знаете, где и как задавать вопросы по учебным материалам, в каких активностях участвовать и так далее. +- Если вы хотели бы проверить ваш прогресс. +- Если вам нужна [пауза в обучении](/docs/learning-process/akademicheskii-otpusk.md). +- Если учиться сложно и вы не знаете, что с этим делать. +- Если вы не получаете поддержку от наставника. +- Если необходимо сменить программу или формат обучения. -## Куратор не выполняет свою задачу, если он: +## Куратор не выполняет свою задачу, если он -* Грубит, указывает, неуместно шутит: +- Грубит, указывает, неуместно шутит: В Хекслете допустимо общаться неформально или чётко задать рамки правил, но это должно оставаться в рамках приличия и не выглядеть, как выговоры. -* Не выходит на связь в рабочее время рабочих дней: +- Не выходит на связь в рабочее время рабочих дней: В идеале, куратор в течение рабочего дня должен ответить хотя бы “Привет, не смогу ответить до завтра”. -* Не выдал ссылки или документы с описанием учебного процесса, не объяснил, куда идти и что делать: +- Не выдал ссылки или документы с описанием учебного процесса, не объяснил, куда идти и что делать: При этом куратор не просто выдаёт ссылки, а должен именно через диалог рассказать, как устроен Хекслет и убедиться, что студент всё понял. -* Не приходит в чате под вопросы без ответов наставников: +- Не приходит в чате под вопросы без ответов наставников: Куратор должен просматривать чат, находить вопросы без ответа и призывать туда наставника. При этом, если студенту помогли другие студенты, то участие куратора и наставника необязательно. -* Не интересуется прогрессом обучения: +- Не интересуется прогрессом обучения: Куратор, как и студент, видит отставание и опережение по контенту. Когда студент начинает отставать, куратор должен прийти и спросить, что случилось, чем можно помочь, где возникли сложности. Даже если студент опережает программу, куратор всё равно должен быть уверен, что студенту комфортно учиться, наставник помогает, активности нравятся. Поэтому минимум 1 раз в месяц куратор должен пообщаться со студентом. -* Выполняет свою работу для галочки: +- Выполняет свою работу для галочки: Система Хекслета проактивная, она не реагирует на ситуации, когда те уже произошли, а выполняет действия наперёд. Для этого куратору надо вовлекаться в жизнь студентов, обсуждения в чате, задавать уточняющие вопросы, а не только реагировать на поступающие обращения. diff --git a/docs/learning-process/prodlenie-obucheniya.md b/docs/learning-process/prodlenie-obucheniya.md index 5f4a8405..069add94 100644 --- a/docs/learning-process/prodlenie-obucheniya.md +++ b/docs/learning-process/prodlenie-obucheniya.md @@ -34,9 +34,8 @@ title: "Продление обучения" Если оплачивали в другой валюте — https://my.tiptoppay.kz/ - ## Всегда готовы помочь Если остались вопросы или что-то пошло не так — пишите в поддержку: support@hexlet.io -Ребята разберутся и подскажут, что делать :) \ No newline at end of file +Ребята разберутся и подскажут, что делать :) diff --git a/docs/learning-process/sroki-obucheniya/sroki-obucheniya.md b/docs/learning-process/sroki-obucheniya/sroki-obucheniya.md index 2c9e9620..02074cfe 100644 --- a/docs/learning-process/sroki-obucheniya/sroki-obucheniya.md +++ b/docs/learning-process/sroki-obucheniya/sroki-obucheniya.md @@ -10,7 +10,7 @@ title: "Сроки обучения" Самое важное в процессе обучения — это регулярность. Залог успеха — вовремя задавать вопросы и не тратить время впустую. -# Программа +## Программа Прежде, чем приступить к обучению, рекомендуем ещё раз ознакомиться со своей программой. Зайдите на страницу [Дашборд](https://ru.hexlet.io/my) и убедитесь, что у вас отображается нужная программа. Если вам необходимо выбрать другой курс, то выберите его в разделе [Мои курсы](https://ru.hexlet.io/my/programs) или [Профессии](https://ru.hexlet.io/my/catalog/professions). @@ -18,26 +18,26 @@ title: "Сроки обучения" ![](/img/docs/img-086.png) -# План обучения +## План обучения -Изучите свою программу и посмотрите, из какого количества модулей и проектов она состоит. Допустим, программа идёт 10 месяцев, имеет 5 модулей и 4 проекта. Тогда рекомендуемый план обучения — это 1 месяц на модуль без проекта и по 2 месяца в среднем на модули с проектом. +Изучите свою программу и посмотрите, из какого количества модулей и проектов она состоит. Допустим, программа идёт 10 месяцев, имеет 5 модулей и 4 проекта. Тогда рекомендуемый план обучения — это 1 месяц на модуль без проекта и по 2 месяца в среднем на модули с проектом. Для модуля с проектом эти 2 месяца распределим так: -* 2-4 недели на все курсы до проекта; -* 2-4 недели на решение проекта; -* до 2 недель на доработки проекта по код-ревью, если вы учитесь с наставником. +- 2-4 недели на все курсы до проекта; +- 2-4 недели на решение проекта; +- до 2 недель на доработки проекта по код-ревью, если вы учитесь с наставником. Это оптимальные сроки, и, чтобы в них уложиться, мы рекомендуем проходить в среднем от 2 до 5 уроков в день. Урок — это теория, тест и практика. Но бывают и уроки, состоящие исключительно из теории. -## Как посмотреть свой прогресс +### Как посмотреть свой прогресс **Если вы учитесь самостоятельно**, то у вас нет ограничений по времени прохождения программы, но на основании рекомендаций выше вы можете ставить себе дедлайны самостоятельно, чтобы обучение проходило продуктивнее. **Если вы учитесь на тарифе с поддержкой наставника**, то ваше обучение рассчитано на определенный срок. Чтобы узнать, какая часть программы уже пройдена и укладываетесь ли вы в отведённое время: -1. Зайдите на страницу [«Мои курсы»](https://ru.hexlet.io/my/programs) -2. Найдите вашу программу и нажмите на её название +1. Зайдите на страницу [«Мои курсы»](https://ru.hexlet.io/my/programs) +2. Найдите вашу программу и нажмите на её название Откроется **страница с прогрессом** по программе, на которой видно: @@ -53,18 +53,18 @@ title: "Сроки обучения" Если видите, что не успеваете к дате завершения, — напишите куратору, и он поможет найти решение. -## Уроки +### Уроки Как понять, что пора обратиться за помощью: -* Если уже 20 минут нет прогресса в решении задачи. -* Когда задача решается, но время решения выходит за 60 минут. Даже самые объёмные задачи в Хекслете не требуют целого часа непрерывного написания кода. +- Если уже 20 минут нет прогресса в решении задачи. +- Когда задача решается, но время решения выходит за 60 минут. Даже самые объёмные задачи в Хекслете не требуют целого часа непрерывного написания кода. -## Проект +### Проект Каждый проект закрепляет темы из пройденного модуля, поэтому будьте последовательны, проходите проекты сразу после завершения модуля. На каждый шаг проекта также рекомендуем тратить несколько часов плотной работы и не более 60 минут на самостоятельное преодоление трудностей. -## Что делать, если вы застряли и решить задачу не получается? +### Что делать, если вы застряли и решить задачу не получается? Когда вы застряли и в течение часа не можете сдвинуться с места, не видите вариантов решения или не можете справиться с ошибкой, почитайте обсуждения или задайте вопрос [ИИ-помощнику](/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md). Если всё равно не получается разобраться, то обратитесь к наставнику. А если вы учитесь самостоятельно, можете задать вопрос в [нашем Сообществе](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). @@ -74,15 +74,15 @@ title: "Сроки обучения" Если вы учитесь без поддержки наставника, но чувствуете потребность в помощи, рассмотрите вариант перехода на тариф [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) или [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md). -# Подсказки на сайте +## Подсказки на сайте В процессе обучения вы будете находить различные подсказки: -* элементы интерфейса; -* ссылки на дополнительные материалы; -* самостоятельные задания; -* обсуждения в упражнениях и проектах; -* [база знаний Хекслета](https://hexlet.github.io/). +- элементы интерфейса; +- ссылки на дополнительные материалы; +- самостоятельные задания; +- обсуждения в упражнениях и проектах; +- [база знаний Хекслета](https://hexlet.github.io/). Используйте их все, чтобы оставаться эффективным. @@ -90,7 +90,7 @@ title: "Сроки обучения" ![](/img/docs/img-087.png) -# Что делать, если я не успеваю? +## Что делать, если я не успеваю? Если вы учитесь по Базовой или Премиум подписке, то дедлайнов у вас нет, продлевать подписку можно бесконечно. Срок доступа к контенту можно увидеть [в разделе “Оплата”](https://ru.hexlet.io/account/subscription). diff --git a/docs/learning-support/kak-pravilno-zadavat-voprosy.md b/docs/learning-support/kak-pravilno-zadavat-voprosy.md index c493d3aa..9d26c390 100644 --- a/docs/learning-support/kak-pravilno-zadavat-voprosy.md +++ b/docs/learning-support/kak-pravilno-zadavat-voprosy.md @@ -14,7 +14,7 @@ title: "Как правильно задавать вопросы" ## Почему это важно -У начинающих часто возникает представление, что опытный программист способен с одного взгляда на код или краткое описание сразу понять суть проблемы. Если бы это было так, чтобы помогать студентам, нам пришлось бы: +У начинающих часто возникает представление, что опытный программист способен с одного взгляда на код или краткое описание сразу понять суть проблемы. Если бы это было так, чтобы помогать студентам, нам пришлось бы: - помнить наизусть тексты уроков, тестов и упражнений - выполнять в голове код на любом языке @@ -46,7 +46,7 @@ title: "Как правильно задавать вопросы" [Replit](https://replit.com/) — для бэкенда и CLI-проектов. -**Как правильно задать вопрос:** Решил задачу в практике, но код проходит только два из трёх тестов. Добавил отладочные выводы — вижу, что на шаге 3 данные не меняются, как ожидалось. Помогите разобраться. *Ссылка на [сохранённое решение](/docs/practice/kak-sohranit-svoe-reshenie.md) или сервис с кодом.* +**Как правильно задать вопрос:** Решил задачу в практике, но код проходит только два из трёх тестов. Добавил отладочные выводы — вижу, что на шаге 3 данные не меняются, как ожидалось. Помогите разобраться. _Ссылка на [сохранённое решение](/docs/practice/kak-sohranit-svoe-reshenie.md) или сервис с кодом._ ### Опишите свои действия @@ -56,7 +56,7 @@ title: "Как правильно задавать вопросы" Собственная интерпретация ошибки студентом вносит ещё больше путаницы. Это похоже на консультацию у врача по телефону. Информация о том, что у пациента болит нога, ничем не поможет врачу, пока не будут сделаны снимки и анализы. Так же и в программировании: пока нет кода и результатов его работы, диагностировать неисправность по одному лишь описанию очень сложно. Если студент опишет свои действия и их результат, то будет проще понять истинную причину ошибки. -**Как правильно задать вопрос:** Выполняю команду ./bin/run из второго шага самостоятельного задания и получаю ошибку bash: ./bin/run: Permission denied. Подскажите, что это значит и как исправить? +**Как правильно задать вопрос:** Выполняю команду ./bin/run из второго шага самостоятельного задания и получаю ошибку bash: ./bin/run: Permission denied. Подскажите, что это значит и как исправить? ### Расскажите, где запускается код @@ -67,13 +67,13 @@ title: "Как правильно задавать вопросы" Даже с кодом и ошибкой невозможно учесть все особенности локальной настройки. Причины могут быть в ОС, версиях ПО, даже в BIOS или железе. **Как правильно задать вопрос:** Запустил код из теории на своём ПК (VS Code, Ubuntu 18.10, версия языка: 3). Запускал через терминал. -Код и лог ошибки выложил на GitHub: *ссылка* +Код и лог ошибки выложил на GitHub: _ссылка_ Если вопрос касается настройки окружения, лучше задать его в [Telegram-сообществе](https://t.me/hexletcommunity) — возможно, другие участники уже сталкивались с подобной ситуацией. ### Используйте отладочную печать -**Вопрос студента:** У меня не работает код, скажите, в чём ошибка. Код: *ссылка*, ошибка: *ссылка*. +**Вопрос студента:** У меня не работает код, скажите, в чём ошибка. Код: _ссылка_, ошибка: _ссылка_. **Реакция специалиста:** Пытался ли студент решить вопрос самостоятельно? Дебажил ли он код? Он не хочет разбираться или действительно не разобрался? @@ -81,4 +81,4 @@ title: "Как правильно задавать вопросы" Посмотрите это видео про отладку, где рассказывается, почему это важный инструмент для каждого программиста: https://www.youtube.com/watch?v=9iwYRcw3A8A -**Как правильно задать вопрос:** На некоторых тестах код прерывает выполнение. Я добавил отладочную печать и увидел, что цикл выполняется несколько раз и потом прерывается, но не понимаю почему. Подскажите, где может быть ошибка: *ссылка на сохраненное решение* +**Как правильно задать вопрос:** На некоторых тестах код прерывает выполнение. Я добавил отладочную печать и увидел, что цикл выполняется несколько раз и потом прерывается, но не понимаю почему. Подскажите, где может быть ошибка: _ссылка на сохраненное решение_ diff --git a/docs/learning-support/kak-zadat-vopros-po-uroku.md b/docs/learning-support/kak-zadat-vopros-po-uroku.md index 8660f4d8..39692486 100644 --- a/docs/learning-support/kak-zadat-vopros-po-uroku.md +++ b/docs/learning-support/kak-zadat-vopros-po-uroku.md @@ -20,4 +20,4 @@ title: "Как задать вопрос по уроку" - А если вы сейчас учитесь самостоятельно (по подписке на Базовый план без поддержки наставника или же проходите бесплатные курсы), загляните в наше [Сообщество](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). В Сообществе можно не только задать вопрос, но и пообщаться с другими разработчиками и студентами. -Если вопросы возникают часто и бывает сложно разобраться в материале, обратите внимание на форматы обучения на тарифах [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) или [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md). \ No newline at end of file +Если вопросы возникают часто и бывает сложно разобраться в материале, обратите внимание на форматы обучения на тарифах [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) или [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md). diff --git a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index b9c1e8ec..d79430de 100644 --- a/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/practice-guides/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -8,27 +8,27 @@ title: "Как использовать GitHub Copilot для решения п > Помощь ИИ при работе над учебным проектом -**GitHub Copilot** — это инструмент, это помощник с искусственным интеллектом, встроенный в редактор кода и сайт GitHub. Он помогает писать код, -объясняет ошибки и подсказывает, как их исправить. Однако важно помнить, что он не должен подменять ваше обучение и выполнять задачи за вас. -Если у вас не проходят тесты, что-то сломалось в GitHub Actions или вы не понимаете, почему код не работает — Copilot может помочь разобраться. +**GitHub Copilot** — это инструмент, это помощник с искусственным интеллектом, встроенный в редактор кода и сайт GitHub. Он помогает писать код, +объясняет ошибки и подсказывает, как их исправить. Однако важно помнить, что он не должен подменять ваше обучение и выполнять задачи за вас. +Если у вас не проходят тесты, что-то сломалось в GitHub Actions или вы не понимаете, почему код не работает — Copilot может помочь разобраться. -Этот инструмент особенно полезен при работе над учебными проектами: он не решает задачи за вас, но подсказывает, куда смотреть и как думать. +Этот инструмент особенно полезен при работе над учебными проектами: он не решает задачи за вас, но подсказывает, куда смотреть и как думать. Всё как у хорошего преподавателя: не даёт готовый ответ, а помогает дойти до него самому. > **Главное правило:** просите Copilot **объяснять**, а не **писать**. Если вы просите написать код — вы не учитесь. Если просите объяснить — учитесь. Разница в формулировке вопроса. -*В некоторых странах Copilot может не работать без VPN.* +_В некоторых странах Copilot может не работать без VPN._ ## Чем Copilot может быть полезен - Помогает понять ошибки — объясняет сообщения, показывает, где именно проблема. - + - Помогает самостоятельно разобраться с тестами — подсказывает, почему они не проходят. - + - Объясняет логику работы кода, а не просто предлагает решения. - + - Показывает примеры и объясняет термины — это помогает лучше усваивать материал. - + - Делает ревью кода перед отправкой на проверку. GitHub Copilot можно использовать как в редакторе, так и на сайте GitHub для анализа, объяснений и улучшения кода. Разберемся, как настроить Copilot в VSCode. @@ -72,7 +72,7 @@ Copilot автоматически читает файл `AGENTS.md` в корн ### Выключение автодополнения -Зачем это нужно? Copilot подсказывает код в реальном времени, но это плохо для обучения, если нет понимания, что делает код. +Зачем это нужно? Copilot подсказывает код в реальном времени, но это плохо для обучения, если нет понимания, что делает код. Чтобы избежать этого, важно использовать Copilot как инструмент для анализа и изучения, а не как источник готовых решений. Задавайте вопросы, уточняйте детали и старайтесь разобраться в предложениях ИИ. Это поможет вам развивать навыки программирования и лучше понимать, как работает код. @@ -81,15 +81,14 @@ Copilot автоматически читает файл `AGENTS.md` в корн 1. Откройте настройки редактора VS Code. 2. Найдите параметр github.copilot.chat.followUps. -4. Установите значение never, чтобы отключить автодополнение. - +3. Установите значение never, чтобы отключить автодополнение. + ![](/img/docs/img-108.png) - -6. В нижнем меню справа нажмите на иконку Copilot и уберите галочки. +4. В нижнем меню справа нажмите на иконку Copilot и уберите галочки. ![](/img/docs/img-109.png) -Это позволит вам использовать Copilot только для анализа и объяснений, а не для автоматического написания кода. +Это позволит вам использовать Copilot только для анализа и объяснений, а не для автоматического написания кода. Такой подход способствует более глубокому пониманию материала и развитию навыков. ## Установка и настройка Copilot в IntelliJ IDEA @@ -173,14 +172,14 @@ Copilot в режиме чата позволяет взаимодействов GitHub Copilot интегрирован в сайт GitHub, что позволяет его использовать для анализа ошибок и улучшения проекта. -**Настройка Copilot на GitHub** +### Настройка Copilot на GitHub Чтобы включить и настроить Copilot на GitHub, выполните следующие шаги: 1. **Перейдите в настройки вашего аккаунта GitHub:** - - Откройте [GitHub Settings](https://github.com/settings). - - Найдите раздел **Copilot**. + - Откройте [GitHub Settings](https://github.com/settings). + - Найдите раздел **Copilot**. 2. **Активируйте Copilot:** @@ -195,7 +194,7 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол - Нажмите на иконку Copilot в правом верхнем углу страницы (рядом с иконкой уведомлений), чтобы открыть чат. - Нажмите на многоточие и выберите **Personal Instructions**. - В поле инструкций напишите текст, например: - + > Ты — наставник, который помогает мне учиться программированию. Не пиши готовые решения — вместо этого объясняй, задавай наводящие вопросы и давай подсказки, чтобы я дошёл до ответа сам. Если я прошу написать код — откажи и спроси, что именно мне непонятно. Отвечай на русском языке. - Сохраните изменения. @@ -212,7 +211,7 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол 5. Скопируйте текст ошибки из логов. 6. Нажмите кнопку Explain error, которая появится рядом с ошибкой. 7. В открывшемся чате с Copilot задайте вопросы. - + ![](/img/docs/img-111.png) Примеры вопросов, которые можно задать Copilot: @@ -221,55 +220,54 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол - Почему процесс упал на шаге [название шага]? - Как исправить ошибку [текст ошибки]? -Copilot может объяснить, на каком этапе произошла ошибка, что она означает, и предложить возможные решения. +Copilot может объяснить, на каком этапе произошла ошибка, что она означает, и предложить возможные решения. Например, если ошибка связана с зависимостями, он может подсказать, как их установить или обновить. ## Как использовать Copilot для ревью тестовой документации -Если вы тестировщик, то Copilot может помочь вам провести ревью тестовой документации, используя заранее подготовленный чеклист +Если вы тестировщик, то Copilot может помочь вам провести ревью тестовой документации, используя заранее подготовленный чеклист (обычно находится на последнем шаге проекта). Вот как это сделать: 1. **Скопируйте чек-лист** — например: - + Ошибки при составлении тест-кейса - Неправильное название тест-кейса - + Неверно: Авторизация пользователя - + Верно: Успешная авторизация пользователя - Ветвление в шагах или ожидаемом результате - + Неверно: Шаг: Авторизоваться под пользователем user01 - + Неверно: ОР: Авторизация успешна. Если пользователя нет, то выводится сообщение «Вы не зарегистрированы» - + Верно: Разнести на два тест-кейса - Лишние детали - + Неверно: Шаг: Нажать на зеленую кнопку «Войти» под полями ввода логина и пароля - + Верно: Шаг: Нажать «Войти» - Недостаток деталей - + Неверно: ОР: Проверить, что авторизация выполнилась успешно - + Верно: ОР: Убедиться, что произошел редирект в личный кабинет 2. Откройте на Github файл с тест-кейсами. 3. Нажмите на иконку Copilot — откроется чат с Copilot. - + ![](/img/docs/img-112.png) - -6. **Напишите промпт для Copilot** — например: - +4. **Напишите промпт для Copilot** — например: + > Сделай ревью тест-кейсов по следующему чеклисту: - > *чек-лист по тест-кейсам* + > _чек-лист по тест-кейсам_ -7. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения. +5. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения. ## Как задавать вопросы Copilot: готовые промпты -Главное отличие: хорошие вопросы просят *понять*, плохие — *получить ответ*. +Главное отличие: хорошие вопросы просят _понять_, плохие — _получить ответ_. ### Тест не проходит @@ -330,7 +328,7 @@ Copilot может объяснить, на каком этапе произош **Хорошо:** > Проверь мои тест-кейсы по этим критериям: [вставь чеклист]. Что нарушено? Объясни каждое замечание. -**Copilot не решает задачи за студента** +#### Copilot не решает задачи за студента Copilot — это **не решатель задач**. Он помогает вам: @@ -340,7 +338,7 @@ Copilot — это **не решатель задач**. Он помогает Не превращайте Copilot в «шпаргалку»! Обязательно разбирайтесь в его предложениях, экспериментируйте и учитесь. -**Советы по работе с Copilot** +#### Советы по работе с Copilot - Задавайте конкретные вопросы. Так вы быстрее получите полезный ответ. - Уточняйте, если объяснение непонятное. @@ -351,7 +349,7 @@ Copilot — это **не решатель задач**. Он помогает ## Вывод -GitHub Copilot — мощный инструмент для обучения и развития. Используйте его, чтобы учиться анализировать ошибки, повышать читаемость кода +GitHub Copilot — мощный инструмент для обучения и развития. Используйте его, чтобы учиться анализировать ошибки, повышать читаемость кода и лучше понимать архитектуру решений. Это инструмент, который помогает вам: - Разобраться в ошибках. @@ -359,5 +357,5 @@ GitHub Copilot — мощный инструмент для обучения и - Улучшить качество кода. - Учиться на практике. -Он не делает проект за вас, но помогает двигаться вперёд самостоятельно. Используйте его для понимания, а не для быстрого решения. +Он не делает проект за вас, но помогает двигаться вперёд самостоятельно. Используйте его для понимания, а не для быстрого решения. Тогда он принесёт настоящую пользу. diff --git a/docs/practice-guides/kak-my-testiruem-testy-utilita-suppressor/kak-my-testiruem-testy-utilita-suppressor.md b/docs/practice-guides/kak-my-testiruem-testy-utilita-suppressor/kak-my-testiruem-testy-utilita-suppressor.md index 796e830a..a1c54801 100644 --- a/docs/practice-guides/kak-my-testiruem-testy-utilita-suppressor/kak-my-testiruem-testy-utilita-suppressor.md +++ b/docs/practice-guides/kak-my-testiruem-testy-utilita-suppressor/kak-my-testiruem-testy-utilita-suppressor.md @@ -10,11 +10,11 @@ title: "Как мы тестируем тесты. Утилита Suppressor" Практики [курсов по тестированию](https://ru.hexlet.io/courses_testing) сильно отличаются от практик других курсов. Обычно вам нужно написать реализацию какой-то функции под существующий набор тестов. Здесь же всё наоборот. Вам нужно написать тесты для готового кода, и система должна проверить правильность выполнения написанных тестов. -Рассмотрим работу практики на конкретном примере. Представьте себе функцию last(), которая возвращает последний элемент в массиве: +Рассмотрим работу практики на конкретном примере. Представьте себе функцию last(), которая возвращает последний элемент в массиве: ![](/img/docs/img-124.png) -Можно ли однозначно утверждать, что она работает верно, основываясь на примере выше? Нет. Вполне возможно, что эта функция реализована так: +Можно ли однозначно утверждать, что она работает верно, основываясь на примере выше? Нет. Вполне возможно, что эта функция реализована так: ![](/img/docs/img-114.png) @@ -22,11 +22,11 @@ title: "Как мы тестируем тесты. Утилита Suppressor" ![](/img/docs/img-115.png) -Достаточно ли теперь? И снова нет. Ее код может быть таким: +Достаточно ли теперь? И снова нет. Ее код может быть таким: ![](/img/docs/img-116.png) -При такой реализации и первый вызов, и второй вернут правильные данные, хотя функция реализована неверно. А вот правильная реализация функции: +При такой реализации и первый вызов, и второй вернут правильные данные, хотя функция реализована неверно. А вот правильная реализация функции: ![](/img/docs/img-117.png) @@ -40,27 +40,26 @@ title: "Как мы тестируем тесты. Утилита Suppressor" ![](/img/docs/img-118.png) -В файле с тестами происходит импорт этого модуля: +В файле с тестами происходит импорт этого модуля: ![](/img/docs/img-119.png) -Теперь самое интересное. В каждом упражнении есть файл Makefile, открыв который можно увидеть, как запускаются тесты: +Теперь самое интересное. В каждом упражнении есть файл Makefile, открыв который можно увидеть, как запускаются тесты: ![](/img/docs/img-120.png) -В этом файле происходит запуск тестов для каждой из реализаций тестируемой функции из файла *functions.js*. +В этом файле происходит запуск тестов для каждой из реализаций тестируемой функции из файла _functions.js_. Наша проверочная система использует для запуска тестов специальную библиотеку [Suppressor](https://github.com/Hexlet/suppressor), которая может понять, успешно ли завершилось выполнение тестов. У неё есть два режима работы: **1. Suppressor проверяет, что тесты выполнились успешно.** В такой проверке в ваши тесты подставляется правильная реализация функции, которая тестируется (без ошибок). - pass – проверяет, что тесты успешно выполнились FUNCTION_VERSION – переменная окружения, которая содержит имя функции, которое надо подставить для текущего запуска тестов ![](/img/docs/img-121.png) - + В таком случае getFunction вернет функцию (items) => items[items.length - 1] Аргумент pass говорит о том, что Suppressor ожидает успешное завершение тестов. Следующий аргумент — команда, которую надо запустить. В случае успеха будет выведено сообщение: @@ -72,8 +71,8 @@ title: "Как мы тестируем тесты. Утилита Suppressor" Expected tests to pass, but error occurred. See output above. Это значит, что для текущего запуска тестов использовалась рабочая (правильная) версия кода, для которой тесты должны завершиться успешно. Если тесты провалились, значит они написаны неправильно. - - В Makefile в строке запуска может не быть переменной окружения FUNCTION_VERSION: + + В Makefile в строке запуска может не быть переменной окружения FUNCTION_VERSION: ![](/img/docs/img-122.png) @@ -82,7 +81,7 @@ title: "Как мы тестируем тесты. Утилита Suppressor" **2. Suppressor проверяет, что тесты упали с ошибкой.** В этом запуске тесты выполняются с неправильной реализацией тестируемой функции. Правильно написанные тесты должны найти ошибку и сигнализировать об этом, то есть упасть. ![](/img/docs/img-123.png) - + В таком случае getFunction вернет функцию (items) => 2 Аргумент fail говорит о том, что Suppressor ожидает, что выполняемая команда завершится с ошибкой. Это будет значить, что тесты написаны верно, и библиотека выведет сообщение: diff --git a/docs/practice-guides/kak-praktikovatsya-v-vypolnenii-sql-zaprosov/kak-praktikovatsya-v-vypolnenii-sql-zaprosov.md b/docs/practice-guides/kak-praktikovatsya-v-vypolnenii-sql-zaprosov/kak-praktikovatsya-v-vypolnenii-sql-zaprosov.md index 71115819..cc1ee6fc 100644 --- a/docs/practice-guides/kak-praktikovatsya-v-vypolnenii-sql-zaprosov/kak-praktikovatsya-v-vypolnenii-sql-zaprosov.md +++ b/docs/practice-guides/kak-praktikovatsya-v-vypolnenii-sql-zaprosov/kak-praktikovatsya-v-vypolnenii-sql-zaprosov.md @@ -8,10 +8,10 @@ title: "Как практиковаться в выполнении SQL запр > В этой статье мы рассказали о том, как практиковаться в работе с базами данных без установки СУБД на свой компьютер. -Обычно работа с базами данных при помощи SQL предполагает, что у вас есть установленный сервер СУБД, к которому можно подключиться. +Обычно работа с базами данных при помощи SQL предполагает, что у вас есть установленный сервер СУБД, к которому можно подключиться. Установить СУБД на локальный компьютер довольно сложно, поэтому мы не будем этого делать ради практики в несложных запросах. -Мы воспользуемся сервисами, которые позволяют попрактиковаться в выполнении запросов прямо в браузере. Один из таких — [DB Fiddle](https://www.db-fiddle.com/). +Мы воспользуемся сервисами, которые позволяют попрактиковаться в выполнении запросов прямо в браузере. Один из таких — [DB Fiddle](https://www.db-fiddle.com/). Это довольно популярный сервис, который поддерживает различные базы данных и не требует регистрации. Так он выглядит: ![](/img/docs/img-131.png) @@ -33,7 +33,7 @@ title: "Как практиковаться в выполнении SQL запр ![](/img/docs/img-126.png) - **Второй вариант.** Если готового скрипта нет, вы можете воспользоваться специальной возможностью — Text to DDL и - DB Fiddle поможет преобразовать текст в SQL-скрипт. Нажмите кнопку **Text to DDL**, далее вы сможете дать вашей таблице имя и наполнить ее данными: + DB Fiddle поможет преобразовать текст в SQL-скрипт. Нажмите кнопку **Text to DDL**, далее вы сможете дать вашей таблице имя и наполнить ее данными: ![](/img/docs/img-127.png) @@ -45,12 +45,12 @@ title: "Как практиковаться в выполнении SQL запр ## Выполнение запросов -Выше мы создали базу данных, теперь можно приступать к выполнению запросов. Для написания запросов используется правая половина окна — поле Query SQL. +Выше мы создали базу данных, теперь можно приступать к выполнению запросов. Для написания запросов используется правая половина окна — поле Query SQL. Для примера напишем запрос, который получит всю информацию из созданной нами таблицы: ![](/img/docs/img-129.png) -Чтобы выполнить этот запрос, нажмите кнопку Run. Результат выполнения запроса появится в нижней части окна. +Чтобы выполнить этот запрос, нажмите кнопку Run. Результат выполнения запроса появится в нижней части окна. Например, если мы выполним запрос выше, то получим такую таблицу: ![](/img/docs/img-130.png) diff --git a/docs/practice-guides/oblachnye-provaidery-dlya-praktik-po-devops.md b/docs/practice-guides/oblachnye-provaidery-dlya-praktik-po-devops.md index f67cfd80..9dda27b9 100644 --- a/docs/practice-guides/oblachnye-provaidery-dlya-praktik-po-devops.md +++ b/docs/practice-guides/oblachnye-provaidery-dlya-praktik-po-devops.md @@ -10,9 +10,9 @@ title: "Облачные провайдеры для практик по DevOps" Практики в курсах по Devops и администрированию выполняются на облачных серверах. Это необходимо, чтобы научиться нарабатывать реальный опыт, плюс сами сервисы невозможно заменить или подменить. -## Если вы учитесь с наставником: +## Если вы учитесь с наставником -Команда Хекслета заранее позаботилась о доступе студентов тарифов [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) и [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md) к Yandex Cloud. Если вы обучаетесь на направлении DevOps, вы можете обратиться к своему куратору и получить промокод для активации доступа к Yandex Cloud на 45 дней. Вместе с промокодом команда подскажет, как его активировать, и ответит на возникающие вопросы по работе с сервисом. +Команда Хекслета заранее позаботилась о доступе студентов тарифов [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) и [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md) к Yandex Cloud. Если вы обучаетесь на направлении DevOps, вы можете обратиться к своему куратору и получить промокод для активации доступа к Yandex Cloud на 45 дней. Вместе с промокодом команда подскажет, как его активировать, и ответит на возникающие вопросы по работе с сервисом. Если возникают вопросы, всегда можно написать в поддержку по адресу support@hexlet.io — специалисты помогут разобраться или передадут информацию нужной команде. @@ -27,7 +27,7 @@ title: "Облачные провайдеры для практик по DevOps" - **Останавливайте или удаляйте ВМ**, когда не работаете. Остановленная ВМ тарифицируется только за диск; удалённая ВМ не тарифицируется совсем. Если конфигурация описана в Terraform/Ansible — удалять безопасно, её легко пересоздать. - **Следите за балансом** в консоли Yandex Cloud: раздел **Биллинг → Обзор**. -## Если вы учитесь самостоятельно: +## Если вы учитесь самостоятельно Почти все провайдеры предоставляют ознакомительный период. Обычно этого хватает для прохождения курсов и проекта. @@ -48,7 +48,7 @@ Yandex Cloud – основное решение, которое мы реком Зарегистрируйтесь в Digital Ocean по [этой ссылке](https://m.do.co/c/e702f9a99145), чтобы получить кредит $200 для ознакомительного использования на 60 дней. Этого срока хватит, чтобы пройти курсы и проекты в течение 60-дневного периода. Digital Ocean снимает средства сразу при использовании, поэтому отключайте сервисы, которые не используете. -**Полезные ссылки** +### Полезные ссылки [Инструкция по Yandex Cloud в блоге Хекслета](https://ru.hexlet.io/blog/posts/chem-zamenit-oblachnyy-provayder-digitalocean-obzor-yandex-cloud) diff --git a/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md b/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md index 379200e9..4282d261 100644 --- a/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md +++ b/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md @@ -30,64 +30,62 @@ title: "Что такое ИИ-помощник и почему он может ## С чем может помочь ИИ-помощник 1. **Объяснить теорию** - Объяснит простыми словами сложные термины и принципы. - - ![](/img/docs/img-173.png) - -3. **Разобрать примеры кода построчно** - Объяснит, что делает каждая строка в коде. Это особенно полезно при изучении алгоритмов, когда важно понять не только синтаксис, но и логику работы. - - ![](/img/docs/img-174.png) - -5. **Объяснить ошибки и вывод тестов** - Если тесты завершаются с ошибками или код не работает, ИИ поможет понять, что пошло не так. Скопируйте вывод тестов или свой код (а лучше — всё сразу) в чат с помощником и попросите его объяснить ошибку и подсказать варианты решения. - - ![](/img/docs/img-175.png) - -7. **Улучшить код** - ИИ-помощник может провести разбор кода и дать подсказки для его улучшения. - - ![](/img/docs/img-176.png) + Объяснит простыми словами сложные термины и принципы. + + ![](/img/docs/img-173.png) + +2. **Разобрать примеры кода построчно** + Объяснит, что делает каждая строка в коде. Это особенно полезно при изучении алгоритмов, когда важно понять не только синтаксис, но и логику работы. + + ![](/img/docs/img-174.png) + +3. **Объяснить ошибки и вывод тестов** + Если тесты завершаются с ошибками или код не работает, ИИ поможет понять, что пошло не так. Скопируйте вывод тестов или свой код (а лучше — всё сразу) в чат с помощником и попросите его объяснить ошибку и подсказать варианты решения. + + ![](/img/docs/img-175.png) + +4. **Улучшить код** + ИИ-помощник может провести разбор кода и дать подсказки для его улучшения. + + ![](/img/docs/img-176.png) ## Как правильно задать вопрос? 1. **Опишите контекст** - ИИ-помощник лучше поймет запрос, если указать тему урока, приложить ваш код или абзац из теории. - **Важно:** помощник не может заглянуть в ваш прогресс по курсу, в код из тренажера или открыть ссылки и файлы, поэтому нужно давать ему всю важную информацию сразу в запросе. + ИИ-помощник лучше поймет запрос, если указать тему урока, приложить ваш код или абзац из теории. + **Важно:** помощник не может заглянуть в ваш прогресс по курсу, в код из тренажера или открыть ссылки и файлы, поэтому нужно давать ему всю важную информацию сразу в запросе. - **Пример:** «У меня задание из урока по циклу for в Python. Нужно вывести все чётные числа от 1 до 20. Я написал код, но он выводит только одно число, помоги найти ошибку». Дальше вставьте код, который вы уже написали, чтобы ИИ-помощник смог его проверить. - - Если нужна помощь с вопросом **в тесте**, то вставьте в свой запрос вопрос из теста полностью, а также укажите изучаемую программу и тему урока. Если всё равно не получается разобраться, то можно перечислить ИИ-помощнику варианты ответа и попросить объяснить, почему одни правильные, а другие — нет. + **Пример:** «У меня задание из урока по циклу for в Python. Нужно вывести все чётные числа от 1 до 20. Я написал код, но он выводит только одно число, помоги найти ошибку». Дальше вставьте код, который вы уже написали, чтобы ИИ-помощник смог его проверить. + + Если нужна помощь с вопросом **в тесте**, то вставьте в свой запрос вопрос из теста полностью, а также укажите изучаемую программу и тему урока. Если всё равно не получается разобраться, то можно перечислить ИИ-помощнику варианты ответа и попросить объяснить, почему одни правильные, а другие — нет. 2. **Разбейте сложный вопрос на несколько частей** - Если вы хотите разобраться в сложном объемном задании или теме, и у вас много вопросов, то лучше задавать их последовательно и разбить на несколько запросов, чтобы получить более точные и полные ответы от ИИ-помощника. - - **Пример.** Вместо «Как работает цикл и как сделать проверку четности, и как это записать в коде?» лучше составить вопрос так: + Если вы хотите разобраться в сложном объемном задании или теме, и у вас много вопросов, то лучше задавать их последовательно и разбить на несколько запросов, чтобы получить более точные и полные ответы от ИИ-помощника. + + **Пример.** Вместо «Как работает цикл и как сделать проверку четности, и как это записать в коде?» лучше составить вопрос так: - Объясни простыми словами, как работает цикл в Python. - Как в Python проверить, что число чётное? - Помоги соединить это в одном коде. 3. **Уточните формат ответа** - Не просите помощника просто решить за вас задание, а используйте его для объяснения сложных моментов. - - **Пример.** Вместо «напиши функцию сортировки массива пузырьком на языке Python» лучше задать несколько вопросов, которые помогут вам лучше понять тему и разобраться с заданием самостоятельно: + Не просите помощника просто решить за вас задание, а используйте его для объяснения сложных моментов. + + **Пример.** Вместо «напиши функцию сортировки массива пузырьком на языке Python» лучше задать несколько вопросов, которые помогут вам лучше понять тему и разобраться с заданием самостоятельно: - Объясни простыми словами, как работает сортировка массива пузырьком. - Дай пример кода на языке Python и объясни каждую строку. - ## Почему ИИ-помощник может иногда ошибаться? ИИ-помощник может иногда допускать ошибки в своих объяснениях по нескольким причинам: - **Недостаток контекста** - ИИ-помощник не «понимает» код так, как человек, а предсказывает наиболее вероятный ответ на основе текста. Если вопрос сформулирован неполно, ИИ может сделать неверные выводы. - + ИИ-помощник не «понимает» код так, как человек, а предсказывает наиболее вероятный ответ на основе текста. Если вопрос сформулирован неполно, ИИ может сделать неверные выводы. + - **Сложные или редкие задачи** - Когда задача нетипичная, использует малоизвестные библиотеки или требует глубокого анализа, ИИ-помощник может дать упрощённый или неправильный вариант решения. - -- **Отсутствие проверки исполнения** - ИИ-помощник не выполняет код в реальном времени, а только «угадывает», что должно произойти, поэтому он не видит ошибок выполнения или неожиданных результатов. - + Когда задача нетипичная, использует малоизвестные библиотеки или требует глубокого анализа, ИИ-помощник может дать упрощённый или неправильный вариант решения. + +- **Отсутствие проверки исполнения** + ИИ-помощник не выполняет код в реальном времени, а только «угадывает», что должно произойти, поэтому он не видит ошибок выполнения или неожиданных результатов. **Вывод:** ИИ — полезный помощник для понимания и объяснений, но его ответы всегда нужно проверять, тестировать и анализировать самостоятельно. diff --git a/docs/practice/kak-nachislyayutsya-bally.md b/docs/practice/kak-nachislyayutsya-bally.md index 3f9e9c21..ac9cc31d 100644 --- a/docs/practice/kak-nachislyayutsya-bally.md +++ b/docs/practice/kak-nachislyayutsya-bally.md @@ -13,4 +13,4 @@ title: "Как начисляются баллы" - Изучение теоретической части урока — **1 балл** - Прохождение тестов — **2 балла** - Решение упражнения или испытания без просмотра решения учителя — **3 балла** -- Решение любого упражнения после просмотра решения учителя — **0 баллов** \ No newline at end of file +- Решение любого упражнения после просмотра решения учителя — **0 баллов** diff --git a/docs/practice/kak-sohranit-svoe-reshenie.md b/docs/practice/kak-sohranit-svoe-reshenie.md index 8fcd13bf..a7003681 100644 --- a/docs/practice/kak-sohranit-svoe-reshenie.md +++ b/docs/practice/kak-sohranit-svoe-reshenie.md @@ -8,15 +8,15 @@ title: "Как сохранить свое решение" Во время выполнения практики вы можете сохранять свои решения. Это не просто удобная, но и полезная функция. Сохранив решение, вы можете: -* приложить ссылку на него, когда задаете вопрос наставнику в учебном чате; -* проанализировать решение: сравнить свое с решением учителя и разобраться, как оно работает; -* зафиксировать версию решения, чтобы позже вернуться и попробовать решить задачу другим, возможно, более изящным способом. +- приложить ссылку на него, когда задаете вопрос наставнику в учебном чате; +- проанализировать решение: сравнить свое с решением учителя и разобраться, как оно работает; +- зафиксировать версию решения, чтобы позже вернуться и попробовать решить задачу другим, возможно, более изящным способом. ## Как сохранить решение во время выполнения практики -* Запустите автоматические тесты -* На вкладке «Вывод» появятся результаты проверки -* Нажмите на кнопку «Сохранить». Система сохранит решение, и кнопка изменится на «Посмотреть» +- Запустите автоматические тесты +- На вкладке «Вывод» появятся результаты проверки +- Нажмите на кнопку «Сохранить». Система сохранит решение, и кнопка изменится на «Посмотреть» ![](/img/docs/img-141.png) @@ -26,9 +26,9 @@ title: "Как сохранить свое решение" На странице решения есть нескольких вкладок: -* условие задания -* решение студента и решение учителя, которое видно после успешного завершения упражнения или подсмотра правильного решения -* тесты и их вывод +- условие задания +- решение студента и решение учителя, которое видно после успешного завершения упражнения или подсмотра правильного решения +- тесты и их вывод Сохраняйте несколько решений одного упражнения и переключайтесь между ними при помощи кнопок версий посередине страницы. diff --git a/docs/practice/vidy-prakticheskih-zadanii.md b/docs/practice/vidy-prakticheskih-zadanii.md index aa09aab9..d097c622 100644 --- a/docs/practice/vidy-prakticheskih-zadanii.md +++ b/docs/practice/vidy-prakticheskih-zadanii.md @@ -10,11 +10,11 @@ title: "Виды практических заданий" Вот подробности о каждом виде: -* **Тест** – выбор правильного ответа из предложенных. Тесты обычно идут сразу после теории в уроке. Обратите внимание, что правильный ответ на вопрос может быть один, а может быть несколько. -* **Упражнение** – выполнение задания в браузере, в тренажере Хекслета. Чаще всего идет сразу после теории или теста в уроке. В основном, в упражнении нужно написать код под определенную задачу. -* **[Испытание](/docs/practice/chto-takoe-ispytanie.md)** – по механизму то же самое, что упражнения, но сложнее. Кроме того, испытания привязываются к целой теме, а не к конкретному уроку. -* **[Проект](/docs/project-work/chto-takoe-proekty.md)** – задача на полноценную разработку приложения, которую студенты выполняют на своем компьютере. Проекты привязываются к модулю в программе. Если вы учитесь с наставником, то завершающий шаг проекта – это ревью от наставника. -* **Самостоятельная работа** – блок с самостоятельным заданием. Это задание не проверяется, студенты делают его самостоятельно у себя локально или в любом другом браузерном редакторе. Чаще всего задание дается в конце теории. +- **Тест** – выбор правильного ответа из предложенных. Тесты обычно идут сразу после теории в уроке. Обратите внимание, что правильный ответ на вопрос может быть один, а может быть несколько. +- **Упражнение** – выполнение задания в браузере, в тренажере Хекслета. Чаще всего идет сразу после теории или теста в уроке. В основном, в упражнении нужно написать код под определенную задачу. +- **[Испытание](/docs/practice/chto-takoe-ispytanie.md)** – по механизму то же самое, что упражнения, но сложнее. Кроме того, испытания привязываются к целой теме, а не к конкретному уроку. +- **[Проект](/docs/project-work/chto-takoe-proekty.md)** – задача на полноценную разработку приложения, которую студенты выполняют на своем компьютере. Проекты привязываются к модулю в программе. Если вы учитесь с наставником, то завершающий шаг проекта – это ревью от наставника. +- **Самостоятельная работа** – блок с самостоятельным заданием. Это задание не проверяется, студенты делают его самостоятельно у себя локально или в любом другом браузерном редакторе. Чаще всего задание дается в конце теории. В зависимости от выбранной профессии и конкретного курса, который вы сейчас проходите, вы можете не увидеть часть из этих практик. Не в каждой профессии есть самостоятельная, не в каждом курсе есть испытания, не в каждом уроке есть тест и упражнение. При этом того объема практических заданий, которые есть в профессии, все равно хватит для того, чтобы закрепить теорию. diff --git a/docs/project-work/avtoproverka-proektov.md b/docs/project-work/avtoproverka-proektov.md index 5f00ab9e..71cce982 100644 --- a/docs/project-work/avtoproverka-proektov.md +++ b/docs/project-work/avtoproverka-proektov.md @@ -12,7 +12,7 @@ tags: **Проекты** — это полноценные приложения, которые студент самостоятельно разрабатывает от начала и до конца. Как и каждое практическое упражнение в Хекслете, проект автоматически проверяется тестами на соответствие требованиям, указанным в задании. Когда проект прошёл проверку, он отмечается как пройденный в профиле студента, и можно продолжать обучение. -# Как работает автоматическая проверка +## Как работает автоматическая проверка Для запуска тестов используется GitHub Action (далее — экшен), который система автоматически добавляет при создании репозитория проекта. Экшен «дожидается», пока студент пройдёт все шаги проекта в интерфейсе на сайте, и активируется на последнем шаге при отправке на проверку. Далее после каждого коммита проект прогоняется через тесты. @@ -22,7 +22,7 @@ tags: ![](/img/docs/img-144.png) -# Как читать результаты автоматической проверки +## Как читать результаты автоматической проверки Перейдите на вкладку **Actions**, выберите слева воркфлоу **hexlet-check**, а справа — результат запуска экшена. ![](/img/docs/img-145.png) @@ -49,7 +49,7 @@ tags: В студенческом проекте (справа) фрагмент страницы оказался ниже, чем нужно (слева), а также есть различия в расположении и оформлении текста. Всё, что отличается, выделено красным на скриншоте посередине. -# Как отлаживать свой код +## Как отлаживать свой код Дебажить код можно тем же способом, что и в практиках — через отладочную печать. Её результат попадёт в общий вывод, вместе с результатами тестов. @@ -59,7 +59,7 @@ tags: В проектах с фронтендом смотрите на снепшоты, полученные из артефактов. Это позволит увидеть свой проект так, как его видели тесты. -# Рекомендации по прохождению проектов +## Рекомендации по прохождению проектов Выполняйте каждый шаг проекта строго в соответствии с требованиями и переходите к следующему. Иногда задание на следующем шаге может привести к значительным изменениям в архитектуре проекта, и придётся переписать ранее реализованный код. Поэтому чем быстрее вы достигните финального шага с минимально необходимым функционалом, тем проще будет увидеть картину целиком. diff --git a/docs/project-work/chto-takoe-proekty.md b/docs/project-work/chto-takoe-proekty.md index 436081e9..4fce5bd5 100644 --- a/docs/project-work/chto-takoe-proekty.md +++ b/docs/project-work/chto-takoe-proekty.md @@ -8,6 +8,6 @@ title: "Что такое проекты" В большинстве профессий программа обучения включает в себя около **4 проектов**, каждый из которых развивает определённую область компетенции программиста. Всё начинается с настройки локального окружения и знакомства с базовым инструментарием разработчика и заканчивается созданием полноценных сайтов, развёрнутых на онлайн-площадках. -Всё это происходит **не после курсов, а во время обучения** — таким образом новые темы усваиваются гораздо глубже и закрепляются на практике. Проекты отвечают на вопрос: *«Зачем мне это надо?»* +Всё это происходит **не после курсов, а во время обучения** — таким образом новые темы усваиваются гораздо глубже и закрепляются на практике. Проекты отвечают на вопрос: _«Зачем мне это надо?»_ Каждый проект становится вкладом в ваше портфолио. Исходный код лежит в вашем личном аккаунте на **GitHub**, и вы можете показать его работодателям. Портфолио из выполненных проектов имеет большое значение при приёме на работу как опытных, так и начинающих разработчиков. Многие работодатели смотрят в первую очередь на GitHub и только потом — в классическое резюме. diff --git a/docs/project-work/faq-po-proektam.md b/docs/project-work/faq-po-proektam.md index c0aa18cd..ff76cefd 100644 --- a/docs/project-work/faq-po-proektam.md +++ b/docs/project-work/faq-po-proektam.md @@ -18,7 +18,7 @@ title: "FAQ по проектам" ## Как долго проверяются проекты? -Автоматизированные тесты проверяют проект в течение нескольких минут, и вы сразу видите результат. +Автоматизированные тесты проверяют проект в течение нескольких минут, и вы сразу видите результат. При работе с наставником время дополнительной проверки — 2–3 рабочих дня. Если наставник не укладывается в этот срок, он вас предупредит. Если наставник без предупреждения задержал срок проверки, обратитесь, пожалуйста, к вашему куратору для решения этого вопроса. diff --git a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md index 366c1b21..5231d4d9 100644 --- a/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md +++ b/docs/project-work/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah/kak-ispolzovat-github-copilot-dlya-resheniya-problem-v-uchebnyh-proektah.md @@ -8,7 +8,7 @@ title: "Чем Copilot может быть полезен" > **Главное правило:** просите Copilot **объяснять**, а не **писать**. Если вы просите написать код — вы не учитесь. Если просите объяснить — учитесь. Разница в формулировке вопроса. -*В некоторых странах Copilot может не работать без VPN.* +_В некоторых странах Copilot может не работать без VPN._ ## Чем Copilot может быть полезен @@ -109,9 +109,9 @@ Copilot автоматически читает файл `AGENTS.md` в корн Пример вопросов, которые можно задать Copilot: -* Что означает эта ошибка? -* Почему тесты не проходят? -* Как исправить эту проблему? +- Что означает эта ошибка? +- Почему тесты не проходят? +- Как исправить эту проблему? ### Как сделать ревью кода с Copilot @@ -125,9 +125,9 @@ Copilot проанализирует решение и предложит улу Пример вопросов, которые можно задать Copilot во время ревью: -* Как можно улучшить этот код? -* Есть ли здесь ошибки или потенциальные проблемы? -* Как сделать этот код более читаемым? +- Как можно улучшить этот код? +- Есть ли здесь ошибки или потенциальные проблемы? +- Как сделать этот код более читаемым? Используйте эти рекомендации, чтобы улучшить качество вашего кода перед отправкой на проверку. @@ -141,10 +141,10 @@ Copilot проанализирует решение и предложит улу Примеры вопросов для чата: -* Как исправить ошибку в этом коде? -* Почему тесты падают? -* Что означает эта ошибка в терминале? -* Как оптимизировать этот фрагмент? +- Как исправить ошибку в этом коде? +- Почему тесты падают? +- Что означает эта ошибка в терминале? +- Как оптимизировать этот фрагмент? Copilot в режиме чата позволяет взаимодействовать с файлами или выделенными фрагментами кода. Вот как это работает: @@ -174,14 +174,16 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол ![Настройки видимости Copilot на GitHub](/img/docs/img-156.png) 3. **Задайте персональные инструкции для Copilot**: - * Откройте любой исходный код на GitHub. - * Нажмите на иконку Copilot в правом верхнем углу страницы (рядом с иконкой уведомлений), чтобы открыть чат. - * Нажмите на многоточие и выберите **Personal Instructions**. - * В поле инструкций напишите текст, например: + - Откройте любой исходный код на GitHub. + - Нажмите на иконку Copilot в правом верхнем углу страницы (рядом с иконкой уведомлений), чтобы открыть чат. + - Нажмите на многоточие и выберите **Personal Instructions**. + - В поле инструкций напишите текст, например: + ```text Ты — наставник, который помогает мне учиться программированию. Не пиши готовые решения — вместо этого объясняй, задавай наводящие вопросы и давай подсказки, чтобы я дошёл до ответа сам. Если я прошу написать код — откажи и спроси, что именно мне непонятно. Отвечай на русском языке. ``` - * Сохраните изменения. + + - Сохраните изменения. Теперь Copilot будет предоставлять ответы на русском языке, объясняя понятия подробно и с примерами, чтобы вам было проще разобраться. @@ -196,17 +198,17 @@ GitHub Copilot интегрирован в сайт GitHub, что позвол 5. Скопируйте текст ошибки из логов. 6. Нажмите кнопку **Explain error**, которая появится рядом с ошибкой. 7. В открывшемся чате с Copilot задайте вопросы, например: - * Что означает эта ошибка? - * Как её исправить? - * Почему процесс упал на этом шаге? + - Что означает эта ошибка? + - Как её исправить? + - Почему процесс упал на этом шаге? ![github copilot explain errors](/img/docs/img-157.png) Пример вопросов, которые можно задать Copilot: -* Что означает эта ошибка в GitHub Actions? -* Почему процесс упал на шаге [название шага]? -* Как исправить ошибку [текст ошибки]? +- Что означает эта ошибка в GitHub Actions? +- Почему процесс упал на шаге [название шага]? +- Как исправить ошибку [текст ошибки]? Copilot может объяснить, на каком этапе произошла ошибка, что она означает, и предложить возможные решения. Например, если ошибка связана с зависимостями, он может подсказать, как их установить или обновить. @@ -215,6 +217,7 @@ Copilot может объяснить, на каком этапе произош Если вы тестировщик, то Copilot может помочь вам провести ревью тестовой документации, используя заранее подготовленный чеклист (обычно находится на последнем шаге проекта). Вот как это сделать: 1. **Скопируйте чек-лист** — например: + ```text ## Ошибки при составлении тест-кейса * Неправильное название тест-кейса @@ -231,14 +234,17 @@ Copilot может объяснить, на каком этапе произош * Неверно: ОР: Проверить, что авторизация выполнилась успешно * Верно: ОР: Убедиться, что произошел редирект в личный кабинет ``` -1. Откройте на Github файл с тест-кейсами. -1. Нажмите на иконку Copilot — откроется чат с Copilot. -3. **Напишите промпт для Copilot** — например: + +2. Откройте на Github файл с тест-кейсами. +3. Нажмите на иконку Copilot — откроется чат с Copilot. +4. **Напишите промпт для Copilot** — например: + ```text Сделай ревью тест-кейсов по следующему чеклисту: # чек-лист по тест-кейсам ``` -4. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения. + +5. **Получите рекомендации** — Copilot проанализирует тест-кейсы и предложит улучшения. ![github copilot repository file chat](/img/docs/img-158.png) @@ -248,7 +254,7 @@ Copilot может объяснить, на каком этапе произош ## Как задавать вопросы Copilot: готовые промпты -Главное отличие: хорошие вопросы просят *понять*, плохие — *получить ответ*. +Главное отличие: хорошие вопросы просят _понять_, плохие — _получить ответ_. ### Тест не проходит @@ -259,7 +265,7 @@ Copilot может объяснить, на каком этапе произош --- -### Ошибка в коде или в терминале +#### Ошибка в коде или в терминале **Плохо:** «Исправь эту ошибку» @@ -268,7 +274,7 @@ Copilot может объяснить, на каком этапе произош --- -### Не понимаю концепцию +#### Не понимаю концепцию **Плохо:** «Напиши пример с замыканием» @@ -277,7 +283,7 @@ Copilot может объяснить, на каком этапе произош --- -### Перед отправкой кода на проверку +#### Перед отправкой кода на проверку **Плохо:** «Улучши мой код» @@ -286,7 +292,7 @@ Copilot может объяснить, на каком этапе произош --- -### Не знаю, с чего начать задачу +#### Не знаю, с чего начать задачу **Плохо:** «Как решить эту задачу?» @@ -295,7 +301,7 @@ Copilot может объяснить, на каком этапе произош --- -### Если вы изучаете тестирование +#### Если вы изучаете тестирование **Плохо:** «Напиши тест-кейс для этой функции» @@ -304,38 +310,37 @@ Copilot может объяснить, на каком этапе произош --- -### Ревью тест-кейсов (для тестировщиков) +#### Ревью тест-кейсов (для тестировщиков) **Хорошо:** > Проверь мои тест-кейсы по этим критериям: [вставь чеклист]. Что нарушено? Объясни каждое замечание. - -## Copilot не решает задачи за студента +### Copilot не решает задачи за студента Copilot — это **не решатель задач**. Он помогает вам: -* Понимать ошибки и получать справочную информацию. -* Учиться хорошим практикам написания кода. -* Находить новые подходы к решению. +- Понимать ошибки и получать справочную информацию. +- Учиться хорошим практикам написания кода. +- Находить новые подходы к решению. Не превращайте Copilot в “шпаргалку”! Обязательно разбирайтесь в его предложениях, экспериментируйте и учитесь. -## Советы по работе с Copilot +### Советы по работе с Copilot -* **Задавайте конкретные вопросы.** Так вы быстрее получите полезный ответ. -* **Уточняйте**, если объяснение непонятное. -* **Проверяйте ответы.** Copilot может ошибаться. -* **Используйте его как наставника**, а не как копипасту. -* **Если Copilot дал готовый код** — попросите объяснить каждую строку и удалите код. Потом напишите сами. -* **Если ответ непонятен** — скажите: «Объясни проще, как будто мне 10 лет» или «Дай аналогию из жизни». +- **Задавайте конкретные вопросы.** Так вы быстрее получите полезный ответ. +- **Уточняйте**, если объяснение непонятное. +- **Проверяйте ответы.** Copilot может ошибаться. +- **Используйте его как наставника**, а не как копипасту. +- **Если Copilot дал готовый код** — попросите объяснить каждую строку и удалите код. Потом напишите сами. +- **Если ответ непонятен** — скажите: «Объясни проще, как будто мне 10 лет» или «Дай аналогию из жизни». -# Вывод +## Вывод GitHub Copilot — мощный инструмент для обучения и развития. Используйте его, чтобы учиться анализировать ошибки, повышать читаемость кода и лучше понимать архитектуру решений. Это инструмент, который помогает вам: -* Разобраться в ошибках. -* Понять, как работают тесты и CI. -* Улучшить качество кода. -* Учиться на практике. +- Разобраться в ошибках. +- Понять, как работают тесты и CI. +- Улучшить качество кода. +- Учиться на практике. Он не делает проект за вас, но помогает двигаться вперёд самостоятельно. Используйте его для понимания, а не для быстрого решения. Тогда он принесёт настоящую пользу. diff --git a/docs/project-work/kak-prohodit-rabota-nad-proektom.md b/docs/project-work/kak-prohodit-rabota-nad-proektom.md index c6636c23..37996032 100644 --- a/docs/project-work/kak-prohodit-rabota-nad-proektom.md +++ b/docs/project-work/kak-prohodit-rabota-nad-proektom.md @@ -15,8 +15,8 @@ title: "Как проходит работа над проектом" 1. Найти проект в [Дашборде](https://ru.hexlet.io/my) выбранной программы и перейти к нему 2. Если к аккаунту не привязан Гитхаб, то понадобится предоставить доступ к нему, нажав на кнопку «Разрешить доступ к GitHub». Это нужно для автоматического создания репозитория проекта и его интеграции с Хекслетом 3. Вернуться на страницу проекта -2. Нажать на кнопку «Подготовить репозиторий» -4. Перейти к первому шагу и начать выполнять задание +4. Нажать на кнопку «Подготовить репозиторий» +5. Перейти к первому шагу и начать выполнять задание ## Работа над проектом diff --git a/docs/project-work/kak-rabotat-v-github-codespaces/kak-rabotat-v-github-codespaces.md b/docs/project-work/kak-rabotat-v-github-codespaces/kak-rabotat-v-github-codespaces.md index 7c1d000a..fb47f9bb 100644 --- a/docs/project-work/kak-rabotat-v-github-codespaces/kak-rabotat-v-github-codespaces.md +++ b/docs/project-work/kak-rabotat-v-github-codespaces/kak-rabotat-v-github-codespaces.md @@ -42,7 +42,7 @@ GitHub Codespaces — это редактор кода прямо в брауз ![Интерфейс VS Code](/img/docs/img-183--codespaces-vscode-interface.png) -По умолчанию в центре открывается превью файла *README.md* — это просто предпросмотр инструкции к проекту, в нём нельзя писать код. Чтобы начать работу, создайте новый файл или откройте нужный файл из Explorer слева. +По умолчанию в центре открывается превью файла _README.md_ — это просто предпросмотр инструкции к проекту, в нём нельзя писать код. Чтобы начать работу, создайте новый файл или откройте нужный файл из Explorer слева. --- @@ -86,14 +86,14 @@ GitHub Codespaces — это редактор кода прямо в брауз Введите команду для запуска и нажмите **Enter**. Команда зависит от языка проекта — имя файла смотрите в задании: -| Язык | Команда | -|------------|--------------------------------------| -| Python | `python <файл>.py` | -| JavaScript | `node <файл>.js` | -| PHP | `php <файл>.php` | -| Go | `go run <файл>.go` | -| Java | `javac <Файл>.java && java <Файл>` | -| C# | `dotnet run` | +| Язык | Команда | +| ---------- | ---------------------------------- | +| Python | `python <файл>.py` | +| JavaScript | `node <файл>.js` | +| PHP | `php <файл>.php` | +| Go | `go run <файл>.go` | +| Java | `javac <Файл>.java && java <Файл>` | +| C# | `dotnet run` | Результат появится в терминале сразу после команды. diff --git a/docs/project-work/onlain-redaktor-onecompiler/onlain-redaktor-onecompiler.md b/docs/project-work/onlain-redaktor-onecompiler/onlain-redaktor-onecompiler.md index 46c3035d..46c29414 100644 --- a/docs/project-work/onlain-redaktor-onecompiler/onlain-redaktor-onecompiler.md +++ b/docs/project-work/onlain-redaktor-onecompiler/onlain-redaktor-onecompiler.md @@ -37,7 +37,7 @@ OneCompiler — это «черновик» для запуска кода. Эт ![Выбор языка на главной странице OneCompiler](/img/docs/img-195--onecompiler-languages.png) ## Запускаем код - + Интерфейс редактора устроен одинаково для всех языков: - **Слева — редактор кода.** Здесь уже открыт файл с небольшим примером (например, `main.py` для Python). Замените его содержимое своим кодом. diff --git a/docs/project-work/podgotovka-k-proektam.md b/docs/project-work/podgotovka-k-proektam.md index 2e4ada13..507438f9 100644 --- a/docs/project-work/podgotovka-k-proektam.md +++ b/docs/project-work/podgotovka-k-proektam.md @@ -8,46 +8,46 @@ title: "Подготовка к проектам" Проекты выполняются на своём компьютере, а не в среде Хекслета, поэтому вам необходимо настроить среду разработки. -# Операционная система +## Операционная система Большая часть веб-приложений разрабатывается под серверы на базе Linux, поэтому и для разработки удобнее всего применять [Ubuntu](https://www.ubuntu.com/) и подобные системы. Также подойдёт macOS. Ниже — рекомендации под каждую операционную систему по первоначальной настройке. Ubuntu или другая Linux-система -* Готова к работе из коробки +- Готова к работе из коробки macOS -* Установите [homebrew](https://brew.sh/) как основной менеджер пакетов -* Установите iterm2 +- Установите [homebrew](https://brew.sh/) как основной менеджер пакетов +- Установите iterm2 Windows -* Первый вариант: установить [WSL2](https://docs.microsoft.com/ru-ru/windows/wsl/install) -* Второй вариант: установить [Ubuntu](https://losst.ru/ustanovka-ubuntu-22-04) +- Первый вариант: установить [WSL2](https://docs.microsoft.com/ru-ru/windows/wsl/install) +- Второй вариант: установить [Ubuntu](https://losst.ru/ustanovka-ubuntu-22-04) -# Командная строка +## Командная строка Умение работать в командной строке очень важно для программиста. Обязательно пройдите курс «[Основы командной строки](https://ru.hexlet.io/programs/cli-basics)» и потренируйтесь работать в Bash перед тем, как начинать проект. -# Git +## Git Работа с системой контроля версий является неотъемлемой частью всего процесса разработки. Пройдите наш курс «[Основы Git](https://ru.hexlet.io/programs/git-basics-free)». Также советуем ознакомиться с дополнительными ресурсами: -* [Интерактивный курс по Git на Github](https://try.github.io/) -* [Книга ProGit](https://git-scm.com/book/ru/v2/) -* [Интерактивное обучение работе с ветками](http://learngitbranching.js.org/) +- [Интерактивный курс по Git на Github](https://try.github.io/) +- [Книга ProGit](https://git-scm.com/book/ru/v2/) +- [Интерактивное обучение работе с ветками](http://learngitbranching.js.org/) -# Github +## Github [Github](https://github.com/) — это онлайн-сервис, на котором расположены проекты, использующие Git. Почти весь открытый софт находится на этом сервисе, а аккаунт на Github — визитная карточка профессионального разработчика. Перед началом проекта создайте свой аккаунт и свяжите его с Хекслетом [в настройках](https://ru.hexlet.io/account/profile/edit). -## Редактор кода +### Редактор кода Рекомендуем использовать полностью бесплатный [VS Code](https://code.visualstudio.com/). Не забудьте поставить плагины под ваши задачи и ваш стек. У нас есть руководство по [настройке VS Code](http://guides.hexlet.io/vscode-js-setup/). -## Язык программирования +### Язык программирования -Убедитесь, что у вас установлена актуальная версия интерпретатора. Обязательно сверяйтесь с официальной документацией, так как в репозиториях операционных систем часто находятся устаревшие версии. \ No newline at end of file +Убедитесь, что у вас установлена актуальная версия интерпретатора. Обязательно сверяйтесь с официальной документацией, так как в репозиториях операционных систем часто находятся устаревшие версии. diff --git a/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md b/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md index 35e82a50..97f14bb9 100644 --- a/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md +++ b/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md @@ -60,7 +60,7 @@ GitHub — это хранилище файлов вашего проекта. ## Что такое «коммит» -При любом изменении (загрузка, создание, редактирование) GitHub просит **подтвердить изменения** — это называется *коммит* (commit). В окне можно оставить описание по умолчанию, а вариант выбрать **Commit directly to the `main` branch** (сохранить сразу в основную ветку) и нажать зелёную кнопку **Commit changes**. +При любом изменении (загрузка, создание, редактирование) GitHub просит **подтвердить изменения** — это называется _коммит_ (commit). В окне можно оставить описание по умолчанию, а вариант выбрать **Commit directly to the `main` branch** (сохранить сразу в основную ветку) и нажать зелёную кнопку **Commit changes**. ![Окно подтверждения изменений (commit)](/img/docs/img-203--github-commit.png) diff --git a/docs/project-work/sovety-po-prohozhdeniyu-proektov.md b/docs/project-work/sovety-po-prohozhdeniyu-proektov.md index 6a21259e..1b589410 100644 --- a/docs/project-work/sovety-po-prohozhdeniyu-proektov.md +++ b/docs/project-work/sovety-po-prohozhdeniyu-proektov.md @@ -18,8 +18,8 @@ title: "Советы по прохождению проектов" Отсюда два вывода: -* С одной стороны, прилагайте максимум усилий, чтобы написать хороший код. Стремитесь к тому, чтобы не пришлось исправлять ошибки при проверке. -* С другой стороны, пишите код так, как можете. Для начала попробуйте написать решение «в лоб» — выберите наиболее простой и понятный вам способ реализации. +- С одной стороны, прилагайте максимум усилий, чтобы написать хороший код. Стремитесь к тому, чтобы не пришлось исправлять ошибки при проверке. +- С другой стороны, пишите код так, как можете. Для начала попробуйте написать решение «в лоб» — выберите наиболее простой и понятный вам способ реализации. ## Не молчите и не замыкайтесь @@ -33,19 +33,19 @@ title: "Советы по прохождению проектов" В зависимости от формата обучения, вопрос можно задать: -* Если вы учитесь на тарифе с поддержкой наставника, то ему можно задавать вопросы через [форму](/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md), которая находится на каждом шаге проекта. Смело обращайтесь к нему в любой момент, когда возникают вопросы по проектам. -* Если вы учитесь на [Премиальном](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md), вы также можете писать вашему наставнику лично — так вы получите помощь быстрее и по любому учебному вопросу. -* Если вы учитесь без поддержки наставника, задавайте вопросы в [нашем Сообществе в Telegram](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). Также, на каждом шаге проекта внизу страницы есть Обсуждения, они доступны в режиме «только для чтения» и ответы на некоторые вопросы можно найти в топиках ваших предшественников. +- Если вы учитесь на тарифе с поддержкой наставника, то ему можно задавать вопросы через [форму](/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md), которая находится на каждом шаге проекта. Смело обращайтесь к нему в любой момент, когда возникают вопросы по проектам. +- Если вы учитесь на [Премиальном](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md), вы также можете писать вашему наставнику лично — так вы получите помощь быстрее и по любому учебному вопросу. +- Если вы учитесь без поддержки наставника, задавайте вопросы в [нашем Сообществе в Telegram](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). Также, на каждом шаге проекта внизу страницы есть Обсуждения, они доступны в режиме «только для чтения» и ответы на некоторые вопросы можно найти в топиках ваших предшественников. На Расширенном, Стандартном и Оптимальном тарифе наставники отвечают на вопросы по проектам максимум в течение 6 рабочих часов по рабочим дням, а за сроком и качеством ответов следят кураторы. При самостоятельном обучении в сообществе отвечают другие студенты, время ответа не регламентировано. Поэтому если вы чувствуете необходимость в оперативной профессиональной помощи и разборе вашего решения (кода), обратите внимание на форматы обучения на тарифах [Расширенный](/docs/formats-and-tarifs/tarifs/tarif-rasshirennyi.md), [Стандартный](/docs/formats-and-tarifs/tarifs/tarif-standartnyi.md), [Оптимальный](/docs/formats-and-tarifs/tarifs/tarif-optimalnyi.md) или [Премиальный](/docs/formats-and-tarifs/tarifs/tarif-premialnyi.md). ## Работа с наставником -* Наставник играет на вашей стороне. В его интересах, чтобы вы качественно выполнили проект; -* Наставник направляет в правильную сторону, но не пишет код за вас. Не стоит ждать от него прямых подсказок или готовых инструкций; -* На проекте отрабатываются ваши навыки работы в команде. При этом наставник выполняет роль [стейкхолдера](https://ru.wikipedia.org/wiki/%D0%A1%D1%82%D0%B5%D0%B9%D0%BA%D1%85%D0%BE%D0%BB%D0%B4%D0%B5%D1%80) проекта. Ваши взгляды могут не совпадать с требованиями, которые предъявляет наставник, — и это нормально. Но при возникновении разногласий и спорных ситуаций, по которым не удаётся прийти к общему решению, последнее слово остаётся за ним; -* Относитесь внимательно к фидбеку от наставника: не стоит пропускать или игнорировать его замечания; -* Приоритетное значение имеет качество кода — он должен быть не только рабочим, но и чистым. Поэтому к замечаниям наставника, касающимся качества и читабельности вашего кода, начиная с именования и заканчивая количеством пробелов, следует подходить со всей серьёзностью. +- Наставник играет на вашей стороне. В его интересах, чтобы вы качественно выполнили проект; +- Наставник направляет в правильную сторону, но не пишет код за вас. Не стоит ждать от него прямых подсказок или готовых инструкций; +- На проекте отрабатываются ваши навыки работы в команде. При этом наставник выполняет роль [стейкхолдера](https://ru.wikipedia.org/wiki/%D0%A1%D1%82%D0%B5%D0%B9%D0%BA%D1%85%D0%BE%D0%BB%D0%B4%D0%B5%D1%80) проекта. Ваши взгляды могут не совпадать с требованиями, которые предъявляет наставник, — и это нормально. Но при возникновении разногласий и спорных ситуаций, по которым не удаётся прийти к общему решению, последнее слово остаётся за ним; +- Относитесь внимательно к фидбеку от наставника: не стоит пропускать или игнорировать его замечания; +- Приоритетное значение имеет качество кода — он должен быть не только рабочим, но и чистым. Поэтому к замечаниям наставника, касающимся качества и читабельности вашего кода, начиная с именования и заканчивая количеством пробелов, следует подходить со всей серьёзностью. ## О списывании diff --git a/docs/site-and-platform/bonusy-za-otzyvy/bonus-za-istoriyu-obucheniya.md b/docs/site-and-platform/bonusy-za-otzyvy/bonus-za-istoriyu-obucheniya.md index 3c18f805..ab0d2bf8 100644 --- a/docs/site-and-platform/bonusy-za-otzyvy/bonus-za-istoriyu-obucheniya.md +++ b/docs/site-and-platform/bonusy-za-otzyvy/bonus-za-istoriyu-obucheniya.md @@ -25,7 +25,6 @@ title: "Бонус за историю обучения" - Какое общее впечатление у вас осталось от обучения - Порекомендовали бы вы Хекслет другим и почему - ## Бонус После публикации вашей истории вы получите **скидку 30% на оплату 3-летней подписки** «Базовый план»: https://ru.hexlet.io/subscription @@ -35,9 +34,9 @@ title: "Бонус за историю обучения" Скидка действует в течение 6 месяцев после завершения доступа к платформе. Например: если вы завершили обучение 20 апреля 2026 года, скидка будет доступна до 20 октября 2026 года. -## Куда отправить историю +## Куда отправить историю Заполните форму: https://forms.yandex.ru/cloud/69dfa40749af4728e13b3417/ -После отправки рекомендуем написать в поддержку: support@hexlet.io — команда проверит вашу историю и вернётся к вам с бонусом. \ No newline at end of file +После отправки рекомендуем написать в поддержку: support@hexlet.io — команда проверит вашу историю и вернётся к вам с бонусом. diff --git a/docs/site-and-platform/bonusy-za-otzyvy/delites_otzyvami_i_poluchayte_bonusy.md b/docs/site-and-platform/bonusy-za-otzyvy/delites_otzyvami_i_poluchayte_bonusy.md index 8bf2b6ea..96052768 100644 --- a/docs/site-and-platform/bonusy-za-otzyvy/delites_otzyvami_i_poluchayte_bonusy.md +++ b/docs/site-and-platform/bonusy-za-otzyvy/delites_otzyvami_i_poluchayte_bonusy.md @@ -19,6 +19,7 @@ title: "Делитесь отзывами и получайте бонусы" ## Если вы уже завершили обучение в Хекслете Если вы ранее учились в Хекслете, но еще не успели поделиться своим впечатлением, то вы можете получить: + - **За 3 текстовых отзыва на разных площадках** — 30 дней доступа; - **За 3 текстовых отзыва и 1 видеоотзыв** — 50 дней доступа. @@ -52,4 +53,4 @@ title: "Делитесь отзывами и получайте бонусы" Полученный промокод применяется в этой форме https://ru.hexlet.io/account/promo_codes/new -**Вы всегда можете уточнить все детали в поддержке, написав на почту support@hexlet.io или в Telegram @hexlet_help_bot, ребята ответят на ваши вопросы :)** \ No newline at end of file +**Вы всегда можете уточнить все детали в поддержке, написав на почту support@hexlet.io или в Telegram @hexlet_help_bot, ребята ответят на ваши вопросы :)** diff --git a/docs/site-and-platform/bonusy-za-otzyvy/instruktsiya-kak-stat-vypusknikom-heksleta-na-habr.md b/docs/site-and-platform/bonusy-za-otzyvy/instruktsiya-kak-stat-vypusknikom-heksleta-na-habr.md index 92f8d3cb..c024b04b 100644 --- a/docs/site-and-platform/bonusy-za-otzyvy/instruktsiya-kak-stat-vypusknikom-heksleta-na-habr.md +++ b/docs/site-and-platform/bonusy-za-otzyvy/instruktsiya-kak-stat-vypusknikom-heksleta-na-habr.md @@ -3,7 +3,7 @@ title: "Инструкция: как стать выпускником Хекс --- 1. Сначала вам необходимо зайти под своими логином и паролем на [Хабр.карьера](https://career.habr.com/) (если они у вас есть), либо зарегистрироваться, если аккаунта нет. - + ![1](/img/docs/img-166.png) 2. Переходим на сайт Хабр.карьера. Там кликаем по иконке личного кабинета в правом верхнем углу и выбираем пункт «Личный кабинет». diff --git a/docs/site-and-platform/bonusy-za-otzyvy/kak-zapisat-videootzyv.md b/docs/site-and-platform/bonusy-za-otzyvy/kak-zapisat-videootzyv.md index 2c6beb6a..db4a2db0 100644 --- a/docs/site-and-platform/bonusy-za-otzyvy/kak-zapisat-videootzyv.md +++ b/docs/site-and-platform/bonusy-za-otzyvy/kak-zapisat-videootzyv.md @@ -28,7 +28,7 @@ title: "Как записать видеоотзыв" 🙏🏻 Задача отзыва — поделиться своим опытом обучения. Представьте, что вы хотите рассказать об обучении у нас своему товарищу, который выбирает, где изучать программирование. Пусть это будет честно, чтобы слушатель понимал все за и против, мог принять взвешенное решение. В примерах ниже приведены пункты, которые можно использовать как опорные точки, но помните, история у каждого своя 😎 -**Пример плана отзыва** +#### Пример плана отзыва - Начать можно так: Привет! Меня зовут _______, на Хекслете я изучаю ______________. - Чем занимались раньше и почему решили сменить сферу деятельности. @@ -58,9 +58,9 @@ title: "Как записать видеоотзыв" 📌 Если же вы хотите оставить отзыв, который будет **больше 5 минут** — такой отзыв лучше всего сразу загружать на YouTube. -### Краткая инструкция по загрузке видео на YouTube: +### Краткая инструкция по загрузке видео на YouTube -**В приложении YouTube** +#### В приложении YouTube - Откройте приложение YouTube . - Нажмите Создать, затем Загрузить видео. @@ -68,7 +68,7 @@ title: "Как записать видеоотзыв" Если вы закроете инструмент загрузки до того, как выполните все нужные действия, ваше видео сохранится на странице Контент в виде черновика. -**В приложении «Творческая студия YouTube»** +#### В приложении «Творческая студия YouTube» 📌 Примечание. Самостоятельно сертифицировать видео в приложении «Творческая студия YouTube» нельзя. @@ -78,11 +78,11 @@ title: "Как записать видеоотзыв" - Укажите название видео (не более 100 символов), выберите тип доступа и задайте настройки монетизации. - Нажмите Далее. - Укажите аудиторию, выбрав «Видео для детей» или «Видео не для детей». -- Нажмите Загрузить. +- Нажмите Загрузить. 📌 И не забывайте ставить хештеги #хекслет #hexlet - это очень сильно помогает при поиске отзывов про нас от других учеников 🙂 -## Как отправить нам исходные файлы: +## Как отправить нам исходные файлы Прикрепить файлом или залить на любое облако и отправить ссылку с открытыми доступами для скачивания на support@hexlet.io. Также будем признательны, если укажешь следующую информацию вместе с отзывом (а также проговоришь эту информацию в видеоотзыве, опционально): @@ -90,7 +90,7 @@ title: "Как записать видеоотзыв" 2. Предыдущее место работы и должность (или текущее, если курсы еще не завершил). 3. Текущее место работы (если завершил курсы). 4. Возраст. -5. Ссылка на любую соц.сеть, если готовы, чтобы к вам приходили с вопросами об обучении. +5. Ссылка на любую соц.сеть, если готовы, чтобы к вам приходили с вопросами об обучении. Готово! diff --git a/docs/site-and-platform/bonusy-za-otzyvy/usloviya-aktsii-i-nachisleniya-bonusov-za-otzyvy-code-basics.md b/docs/site-and-platform/bonusy-za-otzyvy/usloviya-aktsii-i-nachisleniya-bonusov-za-otzyvy-code-basics.md index ccf1e547..11204b66 100644 --- a/docs/site-and-platform/bonusy-za-otzyvy/usloviya-aktsii-i-nachisleniya-bonusov-za-otzyvy-code-basics.md +++ b/docs/site-and-platform/bonusy-za-otzyvy/usloviya-aktsii-i-nachisleniya-bonusov-za-otzyvy-code-basics.md @@ -6,13 +6,13 @@ title: "Условия акции и начисления бонусов за о Делитесь своими честными и информативными отзывами и получайте бонусы! -**7 дней доступа к платформе Хекслет — за текстовый отзыв о [Code Basics](https://code-basics.com/ru).** +**7 дней доступа к платформе Хекслет — за текстовый отзыв о [Code Basics](https://code-basics.com/ru).** ## Условия Бонусы распространяются на отзывы, опубликованные не ранее 01.03.2025. -1. Бонус за отзыв на сайте выдается только после написания отзыва, его можно написать [здесь](https://taplink.cc/codebasics_reviews). **Отзыв должен быть конструктивным и написан о своем личном опыте прохождения любого курса на сайте [Code Basics](https://code-basics.com/ru). В случае, если условие не выполнено, мы вправе отказать в выдаче бонуса.** +1. Бонус за отзыв на сайте выдается только после написания отзыва, его можно написать [здесь](https://taplink.cc/codebasics_reviews). **Отзыв должен быть конструктивным и написан о своем личном опыте прохождения любого курса на сайте [Code Basics](https://code-basics.com/ru). В случае, если условие не выполнено, мы вправе отказать в выдаче бонуса.** 2. Для получения промокода вам необходимо написать нам на почту support@hexlet.io, прикрепив скриншот пройденной формы для сбора отзывов. diff --git a/docs/site-and-platform/chto-takoe-codebattle.md b/docs/site-and-platform/chto-takoe-codebattle.md index 2cf76cab..1eda9b63 100644 --- a/docs/site-and-platform/chto-takoe-codebattle.md +++ b/docs/site-and-platform/chto-takoe-codebattle.md @@ -78,4 +78,4 @@ Codebattle — полноценный **open source-проект**, в кото Codebattle — это не только платформа для соревнований программистов, но и полноценная среда для профессионального роста. Проект объединяет open source-разработку, командную работу и живое сообщество. -А участие в поединках даёт регулярную практику решения задач и учит быстро анализировать условия. Codebattle подходит тем, кто хочет тренироваться и держать себя в тонусе, даже не участвуя в разработке самой платформы. \ No newline at end of file +А участие в поединках даёт регулярную практику решения задач и учит быстро анализировать условия. Codebattle подходит тем, кто хочет тренироваться и держать себя в тонусе, даже не участвуя в разработке самой платформы. diff --git a/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md b/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md index 7754cdc5..cd6acf86 100644 --- a/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md +++ b/docs/site-and-platform/formatirovanie-soobshchenii-dlya-nastavnika.md @@ -16,45 +16,47 @@ title: "Форматирование сообщений для наставни В верхней части окна находятся кнопки для форматирования текста, разметку также можно прописывать самостоятельно. -## Вот основные возможности Маркдауна: +## Вот основные возможности Маркдауна - Для курсивного выделения оберните текст в символы подчеркивания `_вот так_` -- Для полужирного выделения оберните текст в двойные звездочки `**вот так**` -- Для вставки ссылки: `[Текст ссылки](http://google.com)` +- Для полужирного выделения оберните текст в двойные звездочки `**вот так**` +- Для вставки ссылки: `[Текст ссылки](http://google.com)` - Для вставки картинки используйте команду `![](https://ru.hexlet.io/vite/assets/logo_ru_light-BpiEA1LT.svg)` -- Для вывода кода в тексте оберните код `` `бэк-тиками` `` +- Для вывода кода в тексте оберните код `` `бэк-тиками` `` Несколько строк кода нужно выводить блоком. Для этого оберните код тройными тиками и укажите язык, на котором написан код. Например: - - ` ```javascript ` - `int a a = b + 123` + ` ```javascript ` - ` ``` ` - - Вот часть языков, которые можно использовать: go, javascript, typescript, python, php, java. Полный список можно увидеть здесь: https://shiki.style/languages + `int a a = b + 123` + + ` ``` ` + Вот часть языков, которые можно использовать: go, javascript, typescript, python, php, java. Полный список можно увидеть здесь: https://shiki.style/languages - Для списков просто начинайте каждую строку с символа - (ненумерованный список) или с любой цифры с точкой (нумерованный список). Например: - ``` + + ```text - item a - item b - item c ``` - ``` + ```text 1. item one 1. item two 1. item three ``` - Несмотря на то, что во втором случае все цифры одинаковые, при выводе Маркдаун автоматически сделает правильный список: 1, 2, 3 и т.д. + Несмотря на то, что во втором случае все цифры одинаковые, при выводе Маркдаун автоматически сделает правильный список: 1, 2, 3 и т.д. - Чтобы создать вложенный список, используйте отступ в 4 пробела или любое количество пробелов, кратное четырём. - ``` + + ```text - item a - item b 1. item one 1. item two ``` + Чтобы проверить, как сообщение будет выглядеть после отправки, можно включить режим просмотра через кнопку с иконкой «глаз»: ![](/img/docs/img-178.png) diff --git a/docs/site-and-platform/kak-delat-skrinshoty.md b/docs/site-and-platform/kak-delat-skrinshoty.md index d2543ffc..3f1ccae7 100644 --- a/docs/site-and-platform/kak-delat-skrinshoty.md +++ b/docs/site-and-platform/kak-delat-skrinshoty.md @@ -12,7 +12,7 @@ title: "Как делать скриншоты" Делать скриншоты можно так: -* **На Windows**: нажатием на клавиши Print Screen (PrtScn) или Alt + Print Screen (Alt + PrtScn). Клавиша Print Screen позволяет сделать скриншот всего экрана, а комбинация Alt + Print Screen – только активного окна. Можно сразу сохранить скриншот в папку «Изображения» нажатием клавиш «Windows» + «PrintScreen» одновременно, а можно при помощи команды (Ctrl+V) сразу вставить скриншот из буфера обмена в нужное приложение, если оно поддерживает изображения (например, Microsoft Paint, Word, электронное письмо или мессенджер). -* **На Mac**: при помощи одновременного нажатия комбинации клавиш Command + Shift + 3. Найти созданный скриншот можно на рабочем столе или в папке «Снимки экрана». Если же вы хотите сделать скриншот только определенной области экрана, то подойдёт комбинация Command + Shift + 4. При появлении курсора установите начальную точку выделения, зажмите кнопку мыши, после чего переместитесь до конечной точки и отпустите кнопку мыши. -* **На смартфоне с Android** скриншот можно сделать удерживая одновременно кнопки питания и уменьшения громкости. Скриншот будет автоматически сохранен в галерее вашего устройства. -* **На iPhone и iPad** нужно одновременно нажать и удерживать кнопки увеличения громкости и питания. Скриншот сохранится в памяти вашего устройства и будет доступен в приложении «Фото». +- **На Windows**: нажатием на клавиши Print Screen (PrtScn) или Alt + Print Screen (Alt + PrtScn). Клавиша Print Screen позволяет сделать скриншот всего экрана, а комбинация Alt + Print Screen – только активного окна. Можно сразу сохранить скриншот в папку «Изображения» нажатием клавиш «Windows» + «PrintScreen» одновременно, а можно при помощи команды (Ctrl+V) сразу вставить скриншот из буфера обмена в нужное приложение, если оно поддерживает изображения (например, Microsoft Paint, Word, электронное письмо или мессенджер). +- **На Mac**: при помощи одновременного нажатия комбинации клавиш Command + Shift + 3. Найти созданный скриншот можно на рабочем столе или в папке «Снимки экрана». Если же вы хотите сделать скриншот только определенной области экрана, то подойдёт комбинация Command + Shift + 4. При появлении курсора установите начальную точку выделения, зажмите кнопку мыши, после чего переместитесь до конечной точки и отпустите кнопку мыши. +- **На смартфоне с Android** скриншот можно сделать удерживая одновременно кнопки питания и уменьшения громкости. Скриншот будет автоматически сохранен в галерее вашего устройства. +- **На iPhone и iPad** нужно одновременно нажать и удерживать кнопки увеличения громкости и питания. Скриншот сохранится в памяти вашего устройства и будет доступен в приложении «Фото».