Чек-лист: проект готов к публикации
Урок 4 модуля 2. Восемь простых проверок перед тем, как показать проект другим.
Сначала — спокойно
Это не экзамен. Представьте, что перед выходом из дома вы проверяете: выключен ли утюг, закрыта ли вода. Пять минут — и уходите со спокойной душой. Здесь то же самое, только для вашего проекта.
Проверок восемь. Идите по ним сверху вниз, не спеша.
Если какая-то проверка не прошла — ничего страшного. Просто вернитесь и поправьте, а показывать проект будете чуть позже. Ни одна из этих проверок не может сломать проект. Вы ничего не трогаете внутри — только смотрите, всё ли на месте.
В списке встретятся слова из прошлых уроков — например, «репозиторий» и «коммит». Если что-то подзабылось, не переживайте: рядом я коротко напомню, что это значит.
Если на каком-то пункте застряли — просто попросите ИИ. Покажите ему, что видите на экране, и напишите «помоги разобраться». Ровно как делали раньше.
1. Проект открывается и работает
Почему это важно. Прежде чем что-то показывать людям — убедитесь, что показывать есть что.
Что сделать. Откройте свой трекер заново, прямо сейчас. Не «вчера ведь работал», а именно сейчас: открыли → добавили привычку → поставили галочку → проверили, что программа откликается.
Всё в порядке, если: трекер открылся и на ваши нажатия отвечает.
2. На виду нет паролей и секретных ключей — это самая важная проверка
Почему это важно. Когда вы выкладываете проект на GitHub, его может увидеть кто угодно — это как объявление, вывешенное у подъезда: видят все прохожие. Больше того, по интернету «бродят» специальные программы-роботы, которые нарочно ищут в чужих проектах забытые пароли, чтобы ими воспользоваться. Оставить пароль на виду — всё равно что оставить ключ в замке входной двери.
Что сделать — проверьте три вещи:
Всё в порядке, если: ничего секретного в открытом доступе не лежит.
Сейчас, на трекере, эта проверка почти пустая — секретов ещё нет. Но дальше по курсу они появятся: в третьем модуле — особые ключи для подключения к другим сервисам, в пятом — секретный код вашего Telegram-бота. Вот тогда эта проверка станет по-настоящему важной. Поэтому привыкаем к ней уже сейчас, на безопасном примере.
3. Есть описание проекта (файл README)
Почему это важно. README — это «табличка» вашего проекта, как вывеска у магазина. Это первое, что видит человек, открывший ваш проект. Без неё проект выглядит брошенным.
Что сделать. Откройте свой проект на GitHub. Под списком файлов должно быть видно описание: что это за проект и что он умеет.
Всё в порядке, если: описание на месте и его можно прочитать. (Как его сделать — в отдельном гайде «Делаем README вместе с ИИ».)
4. В описании есть картинка проекта, и она видна
Почему это важно. Картинка решает половину впечатления. Представьте два одинаковых проекта: у одного есть картинка, у другого нет. Заказчик выберет тот, где картинка, — глазами так удобнее.
Что сделать. Откройте описание проекта на GitHub. Картинка вашего трекера должна быть видна — то есть показываться как настоящее фото, а не как серый пустой прямоугольник со значком «фото не загрузилось».
Всё в порядке, если: на странице видно живую картинку трекера.
Вместо картинки серый прямоугольник? Это значит, что название файла с картинкой и название, записанное в описании, не совпали. И то и другое должно быть screenshot.png, а сам файл должен лежать рядом с описанием. Подробно — в гайде по README.
5. На картинке не видно ничего личного
Почему это важно. Всё, что попало на картинку, увидят все, кто откроет ваш проект. Как фотография, вывешенная на общей доске объявлений.
Что сделать. Посмотрите на свою картинку внимательно: не видно ли на ней вашей почты, номера телефона, настоящих личных записей, чужих имён.
Всё в порядке, если: ничего личного на картинке нет. А если есть — закрасьте это в любой программе для картинок.
6. Проект нормально выглядит на телефоне
Почему это важно. Больше половины людей откроют вашу ссылку именно с телефона. Если там всё «разъехалось» — впечатление испорчено.
Что сделать. Откройте трекер на телефоне. Нет телефона под рукой — возьмите край окна браузера на компьютере мышкой и потяните, сделав окно узким, как экран телефона. Посмотрите: кнопки не налезают друг на друга, текст читается, ничего не вылезает за край.
Всё в порядке, если: на узком экране всё аккуратно и удобно.
Всё разъезжается? Попросите ИИ: «сделай так, чтобы трекер удобно смотрелся на телефоне и кнопки не налезали друг на друга».
7. Отметки не пропадают после обновления страницы
Почему это важно. Если галочки исчезают, стоит только обновить страницу, — таким трекером пользоваться невозможно.
Что сделать. Поставьте пару галочек. Затем обновите страницу — нажмите клавишу F5 (она в самом верхнем ряду клавиатуры, обновляет страницу). Галочки должны остаться на месте.
Всё в порядке, если: после обновления отметки никуда не делись.
Важно понимать: отметки пока хранятся только в этом браузере на этом компьютере. Если вы зайдёте с телефона — там будет пусто, и это нормально для нашего этапа. Сделать так, чтобы данные были едины на всех устройствах, мы научимся в третьем модуле — там будет разговор про хранилище данных.
8. Свежая версия отправлена на GitHub
Почему это важно. Ваша последняя версия должна лежать в интернете, на GitHub, а не только у вас на компьютере. Иначе другие люди увидят старую версию.
Что сделать. Вспомните привычный порядок из начала урока: сохранил → подписал, что поменял → отправил. Убедитесь, что вы прошли его до конца и на GitHub лежит именно то, что сейчас у вас на экране.
Маленькое напоминание: «коммит» — это и есть сохранение с короткой подписью, что вы изменили. А «отправить» — это переслать это сохранение в интернет, на GitHub.
Всё в порядке, если: на GitHub лежит та же версия, что у вас на экране прямо сейчас.
Просто сохранить файл на компьютере (нажать одновременно Ctrl и S, на Маке — Cmd и S) — это ещё не отправка в интернет. Нужно сделать коммит и отправить. Это разбирали в начале урока.
Все восемь галочек стоят?
Значит, проект готов, чтобы его показывать. Дать человеку ссылку, по которой проект откроется прямо у него, мы научимся в следующем модуле. А пока у вас есть аккуратный, проверенный проект, который не стыдно открыть перед кем угодно.
Если застряли на каком-то пункте дольше 15 минут — не сидите в одиночку, напишите в чат и приложите картинку того, что видите на экране. Это не «я не справляюсь». Так делают все, кто учится. Спрашивать — нормально.