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 ff28ebc..126b147 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 @@ -11,11 +11,8 @@ title: "Где найти список всех-всех курсов?" Такой страницы, чтобы на ней были собраны вообще все-все курсы, у нас нет. Мы сторонники немного другого подхода, когда курсы собраны в программы — профессии и навыки. -Поэтому большинство курсов не отображаются в общем каталоге, так как они находятся внутри определенных программ. Вы можете -**открыть содержание** каждой профессии/программы, чтобы посмотреть, какие курсы туда входят. Каждый курс можно будет открыть, -чтобы посмотреть, какие уроки входят :) +Поэтому большинство курсов не отображаются в общем каталоге, так как они находятся внутри определенных программ. Вы можете ознакомиться с содержанием программы в блоке **«Программа обучения»/«Программа курса»** на её странице: там будет отображен полный список тем. -А просто ознакомиться с содержанием профессий можно в блоке **«Программа обучения»/«Программа курса»** на странице -любой профессии: там будет отображен полный список входящих курсов. +Каталог программ доступен по ссылке: https://ru.hexlet.io/courses ![](/img/docs/img-049.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 e4d7d73..2a4434d 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 @@ -11,7 +11,7 @@ title: "Куда пропал мой код?" Если после прохождения урока долго не заходить в тренажёр, ваше решение может перестать отображаться в нём. При этом отметка о прохождении урока сохранится, если задание было выполнено успешно. -Восстановить «пропавшее» решение невозможно. Чтобы избежать потери, вы можете заранее **сохранить его** во время прохождения практики — тогда оно +Восстановить «пропавшее» решение невозможно. Чтобы избежать потери, вы можете заранее **[сохранить его](/docs/practice/kak-sohranit-svoe-reshenie.md)** во время прохождения практики — тогда оно навсегда останется в вашем аккаунте. ![](/img/docs/img-054.png) diff --git a/docs/faq/reshenie-uchitelya/reshenie-uchitelya.md b/docs/faq/reshenie-uchitelya/reshenie-uchitelya.md index 7665480..e89bcb7 100644 --- a/docs/faq/reshenie-uchitelya/reshenie-uchitelya.md +++ b/docs/faq/reshenie-uchitelya/reshenie-uchitelya.md @@ -8,7 +8,7 @@ title: "Решение учителя" > Где найти и как посмотреть -**Решение учителя** доступно **в меню справа** (кнопка "Подсказка") в каждом упражнении. Оно предназначено для того, чтобы студент мог подсмотреть готовое решение, если застрял и не может продвинуться дальше. +**Решение учителя** доступно на странице с [сохраненным решением](/docs/practice/kak-sohranit-svoe-reshenie.md) в каждом упражнении. Оно предназначено для того, чтобы студент мог подсмотреть готовое решение, если застрял и не может продвинуться дальше. Решение появляется **через 20 минут** после начала прохождения практики. Это сделано намеренно: мы считаем важным, чтобы сначала студент попробовал найти решение самостоятельно, изучил разные подходы и методы. diff --git a/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md b/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md index fb87773..69f0781 100644 --- a/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md +++ b/docs/faq/ya-mogu-imet-bolshe-odnogo-akkaunta.md @@ -15,5 +15,5 @@ title: "Я могу иметь больше одного аккаунта?" Удалить лишние аккаунты всегда можно в настройках в этом разделе: https://ru.hexlet.io/account/settings/edit -**Важно:** если вышло так, что вы учились одновременно с разных аккаунтов (например, один аккаунт был открыт на телефоне, а другой на компьютере), +**Важно:** если вышло так, что вы учились одновременно с разных аккаунтов (например, один аккаунт был открыт на телефоне, а другой — на компьютере), а после заметили и захотели объединить прогресс — так сделать не получится, прогресс навсегда сохраняется в профиле, перенести или очистить его нельзя. diff --git a/docs/getting-started/chto-takoe-professii-v-hekslete.md b/docs/getting-started/chto-takoe-professii-v-hekslete.md index 0750fe0..f36a7ee 100644 --- a/docs/getting-started/chto-takoe-professii-v-hekslete.md +++ b/docs/getting-started/chto-takoe-professii-v-hekslete.md @@ -2,7 +2,7 @@ title: "Что такое «профессии» в Хекслете?" --- -«Профессии» в Хекслете — это полноценные программы обучения, включающие в себя курсы и проекты одного направления, в рамках которых изучаются навыки и инструменты, необходимые для работы в IT. В таких программах можно обучаться веб-разработке, тестированию и аналитике данных. С полным списком программ можно ознакомиться на этой странице: [https://ru.hexlet.io/courses](https://ru.hexlet.io/courses). +«Профессии» в Хекслете — это полноценные программы обучения, включающие в себя курсы и проекты одного направления, в рамках которых изучаются навыки и инструменты, необходимые для работы в IT. В таких программах можно обучаться веб-разработке, тестированию и аналитике данных. С полным списком программ можно ознакомиться на этой странице: https://ru.hexlet.io/courses_purchase ## Кому подходят? @@ -12,6 +12,6 @@ title: "Что такое «профессии» в Хекслете?" ## Как пройти? -Изначально все профессии рассчитаны для обучения в группе с наставником на тарифах [Оптимальный](/docs/learning-formats/tarif-optimalnyi.md) и [Премиальный](/docs/learning-formats/tarif-premialnyi.md). Оба этих тарифа предусматривают помощь наставника и куратора, а также подключение [Хекслет.Карьеры](/docs/career/hekslet-karera.md) для помощи с трудоустройством. Доступные тарифы для конкретной профессии можно посмотреть на её странице из списка. +Изначально все профессии рассчитаны на обучение с наставником на тарифах [Оптимальный](/docs/learning-formats/tarif-optimalnyi.md) и [Премиальный](/docs/learning-formats/tarif-premialnyi.md). Оба этих тарифа предусматривают помощь наставника и куратора, а также подключение к [Хекслет.Карьере](/docs/career/hekslet-karera.md) для помощи с трудоустройством. Доступные тарифы для конкретной профессии можно посмотреть на её странице из каталога. Ещё можно самостоятельно пройти материалы профессий по трехлетней подписке на [Базовый план](/docs/learning-formats/bazovyi-plan.md), но такой формат обучения в основном подходит практикующим разработчикам, которым не требуется помощь наставника в процессе обучения и другие преимущества групповых тарифов. diff --git a/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md b/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md index 2084215..eaa85f4 100644 --- a/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md +++ b/docs/getting-started/kak-ustroeny-kursy-v-hekslete.md @@ -16,7 +16,7 @@ title: "Как устроены курсы в Хекслете" Теория состоит из текста или видео. В конце может быть раздел со ссылками на дополнительные материалы, они полезны, но необязательны для того, чтобы двигаться дальше — теории урока достаточно для прохождения тестов и выполнения упражнения. -Когда вы посмотрели видео и прочитали текст, нажимайте на кнопку «Далее» в правом верхнем углу. Этот шаг урока будет отмечен как завершенный, и вы попадёте на следующий шаг. +Когда вы посмотрели видео и прочитали текст, нажимайте на кнопку «Дальше» в правом верхнем углу. Этот шаг урока будет отмечен как завершенный, и вы попадёте на следующий шаг. # Тест @@ -44,4 +44,4 @@ title: "Как устроены курсы в Хекслете" Спустя некоторое время ваше решение пропадет из пройденного урока, поэтому чтобы не потерять код, лучше сохранить его. Подробнее о том, как сохранить свой код можно узнать в [этой статье](/docs/practice/kak-sohranit-svoe-reshenie.md). -Упражнение всегда можно вернуть к начальному состоянию с помощью кнопки «Сброс». Сброс удалит весь написанный вами код. Если он вам нужен, сохраните его где-нибудь перед сбросом. +Упражнение всегда можно вернуть к начальному состоянию с помощью кнопки «Сбросить». Сброс удалит весь написанный вами код. Если он вам нужен, сохраните его отдельно перед сбросом. diff --git a/docs/learning-formats/bazovyi-plan.md b/docs/learning-formats/bazovyi-plan.md index e3e2054..11d8ce9 100644 --- a/docs/learning-formats/bazovyi-plan.md +++ b/docs/learning-formats/bazovyi-plan.md @@ -21,7 +21,7 @@ title: "Базовый план" Студенты самостоятельно проходят курсы в среде Хекслета в браузере, без привязки ко времени и месту. Количество курсов, которое можно пройти за месяц, не ограничено. Также студенты сами определяют, в каком порядке проходить курсы — они доступны сразу все, но мы рекомендуем двигаться по учебному плану выбранной программы. -Правильность выполнения заданий проверяют автоматизированные тесты, а качества кода — линтер. +Правильность выполнения заданий проверяют автоматизированные тесты. Если возникнут вопросы по урокам, можно обращаться к ИИ-помощнику и в наше [Сообщество](/docs/community-and-media/telegram-soobshchestvo-heksleta.md). В Сообществе можно не только задать вопрос, но и пообщаться с другими разработчиками и студентами. diff --git a/docs/practice-guides/ne-mogu-vypolnit-praktiku.md b/docs/practice-guides/ne-mogu-vypolnit-praktiku.md index 08390be..485682a 100644 --- a/docs/practice-guides/ne-mogu-vypolnit-praktiku.md +++ b/docs/practice-guides/ne-mogu-vypolnit-praktiku.md @@ -19,7 +19,7 @@ title: "Не могу выполнить практику" Как задать вопрос: - Прочитайте нашу статью [«Как правильно задавать вопросы»](/docs/learning-support/kak-pravilno-zadavat-voprosy.md) -- Оформите код, иначе его очень сложно, а иногда невозможно прочитать. Следите за отступами, исправьте замечания линтера +- Оформите код, иначе его очень сложно, а иногда невозможно прочитать, следите за отступами - [Сохраните ваше решение](/docs/practice/kak-sohranit-svoe-reshenie.md) и вставьте ссылку на него в сообщение - Расскажите, что вы уже успели понять во время отладки. С одной стороны это поможет отвечающему разобраться в причинах ошибки, с другой — покажет, что вы пытались самостоятельно разобраться с проблемой, что очень ценится в среде профессионалов и рождает повышенное желание помочь :) 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 89f7b59..afe902b 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 @@ -12,7 +12,7 @@ title: "Что такое ИИ-помощник и почему он может ## Как обратиться к ИИ-помощнику для помощи с уроком? -Кнопку обращения к ИИ-помощнику можно найти на странице каждого урока в меню справа. +Кнопку обращения к ИИ-помощнику можно найти на странице каждого урока справа сверху. ![](/img/docs/img-171.png) diff --git a/docs/practice/chto-takoe-ispytanie.md b/docs/practice/chto-takoe-ispytanie.md index b96624f..95d8e7f 100644 --- a/docs/practice/chto-takoe-ispytanie.md +++ b/docs/practice/chto-takoe-ispytanie.md @@ -8,7 +8,7 @@ title: "Что такое Испытание?" > Подробно об одном из видов практики в Хекслете. -Это дополнительное практическое задание для получения опыта в программировании и закрепления полученных навыков в ранее пройденном курсе. Мы стараемся делать испытания практически ко всем курсам Хекслета, но доступны они только студентам, у которых активен один из платных тарифов. При бесплатном обучении испытания закрыты. +Испытание — это дополнительное практическое задание для получения опыта в программировании и закрепления полученных навыков в ранее пройденном курсе. Мы стараемся делать испытания практически ко всем курсам Хекслета, но доступны они только студентам, у которых активен один из платных тарифов. При бесплатном обучении испытания закрыты. ## Обязательно ли их выполнять? diff --git a/docs/practice/chto-takoe-linter.md b/docs/practice/chto-takoe-linter.md deleted file mode 100644 index d951f02..0000000 --- a/docs/practice/chto-takoe-linter.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: "Что такое линтер" ---- - -[Перейти на сайт](https://ru.hexlet.io) - -# Что такое линтер - -В практических упражнениях на платформе Хекслета код решения проверяют не только [тесты](/docs/code-and-test-errors/kak-naiti-oshibki-v-kode.md), но и линтер. Линтер — программа, которая проверяет код на соответствие стандартам в соответствии с определённым набором правил. Правила описывают отступы, названия создаваемых сущностей, скобки, математические операции, длину строк и множество других аспектов. Каждое отдельное правило кажется не очень важным, но соблюдение их всех — основа хорошего кода. - -Главная задача линтера — сделать код единообразным, удобным для восприятия и самим программистом, и другими людьми, которые будут читать код. В разных командах могут использоваться разные линтеры и разные наборы правил для них, но главное — уметь работать с линтером в принципе, а привыкнуть писать по определенным правилам будет несложно. - -## Линтер в упражнениях - -![](/img/docs/img-091.png) - -Замечания линтера в упражнениях выводятся в нижней части экрана во вкладке Linter. На скриншоте пример для языка JavaScript и линтера ESLint, но похожая информация есть и в выводе других линтеров. - -В выводе линтера вы всегда найдёте имя файла, в котором обнаружены ошибки. Под ним будет список ошибок с указанием номера строчки в файле и номера символа в ней, кратким описанием и названием правила, которое было нарушено. - -Чтобы разобраться с непонятной ошибкой, введите её название в поисковике — одной из первых ссылок в выдаче будет сайт линтера. Обычно там есть более подробное описание ошибки, а также примеры хорошего и плохого кода, который её иллюстрирует. Исправьте код так, чтобы линтер был доволен :) - -Если будет непонятно, как исправить ошибку, спросите [ИИ-помощника](/docs/practice/chto-takoe-ii-pomoshchnik-i-pochemu-on-mozhet-oshibatsya.md) или [сохраните свое решение](/docs/practice/kak-sohranit-svoe-reshenie.md) и обратитесь к наставнику. - -## Какие линтеры мы используем в Хекслете - -* JavaScript. ESLint + Airbnb Style Guide - [Сайт линтера](https://eslint.org/) · [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript) · [Перевод гайда](https://github.com/leonidlebedev/javascript-airbnb) -* PHP. PHP\_CodeSniffer + PSR12 - [Репозиторий](https://github.com/squizlabs/PHP_CodeSniffer) · [Документация](https://github.com/squizlabs/PHP_CodeSniffer/wiki) -* Python. flake8 + wemake\_python\_styleguide - [Список проверок](https://wemake-python-styleguide.readthedocs.io/en/latest/pages/usage/violations/index.html) -* HTML. HTMLHint. Используем стандартные настройки - [Список правил](https://htmlhint.com/docs/user-guide/list-rules) -* CSS. Stylelint. Изменены некоторые настройки, которые касаются порядка свойств. В остальном — стандартная конфигурация - [Список правил](https://stylelint.io/user-guide/rules/list) diff --git a/docs/practice/kak-sohranit-svoe-reshenie.md b/docs/practice/kak-sohranit-svoe-reshenie.md index 12de8b9..08ac090 100644 --- a/docs/practice/kak-sohranit-svoe-reshenie.md +++ b/docs/practice/kak-sohranit-svoe-reshenie.md @@ -16,7 +16,7 @@ title: "Как сохранить свое решение" * Запустите автоматические тесты * На вкладке OUTPUT появятся результаты проверки -* Нажмите на кнопку «Сохранить код». Система сохранит решение, и кнопка изменится на «Посмотреть решение» +* Нажмите на кнопку «Сохранить». Система сохранит решение, и кнопка изменится на «Посмотреть» ![](/img/docs/img-141.png) @@ -24,7 +24,7 @@ title: "Как сохранить свое решение" Все ваши решения сохраняются в личном кабинете, в разделе «[Мои решения](https://ru.hexlet.io/my/code_reviews)». -На странице есть нескольких вкладок: +На странице решения есть нескольких вкладок: * условие задания * решение студента и решение учителя, которое видно после успешного завершения упражнения