Советы по улучшению GitHub-профиля | DevsDay.ru

IT-блоги Советы по улучшению GitHub-профиля

techrocks.ru 17 октября 2020 г. Редакция techrocks.ru


Перевод статьи «Tips for your GitHub Portfolio».

Photo by Headway on Unsplash

Несколько недель назад сразу два человека задали мне один и тот же вопрос: «Как можно улучшить свой GitHub-профиль

Поскольку это не первый раз, когда меня об этом спрашивают, я решил ответить публично.

Прежде чем начать, хотелось бы кое-что подчеркнуть. Профиль на GitHub не является и не должен являться чем-то обязательным. Он относится к разряду «если есть — хорошо».

Качество важнее количества

Такие профили на GitHub встречаются довольно часто:

Человек выбрал шесть репозиториев и закрепил их. Все эти репозитории имеют по три коммита и никаких readme. Создается впечатление, что этот разработчик любит экспериментировать, но так и не создал ничего впечатляющего. Если рекрутер спросит: «С какой проблемой вы столкнулись при работе над этим проектом и как ее решили?», возможностей для красивого ответа будет мало.

Не поймите меня неправильно: нет ничего дурного в том, чтобы экспериментировать с новыми технологиями! У меня самого в профиле на GitHub тоже полно «hello world»-проектов. Но в моем профиле они не закреплены. Я закрепляю только то, что мне кажется важным и подходящим к случаю. Я знаю, что у рекрутеров нет времени изучать все мои проекты. Поэтому на момент написания этой статьи у меня пять закрепленных.

В общем, вместо того чтобы показывать шесть маленьких проектов, выберите один и хорошенько его «отполируйте».

Учитесь публично

«Не выкладывайте на GitHub неидеальные проекты».

Так говорил один разработчик-сеньор, с которым мне довелось работать. Я думаю, это неверный подход. Если брать в целом, люди, которые боятся допускать ошибки, так ничего и не достигают. Посмотрите на популярные репозитории на GitHub: большинство из них далеки от совершенства. И это прекрасно!

Кроме того, если однажды кто-нибудь вдруг захочет изучить git-лог вашего проекта и обнаружит, что вы забыли скобку (или точку с запятой), я не думаю, что этот человек выскажет вам претензии по этому поводу. Но даже если такое произойдет, считайте, что вам повезло: вы получили шанс сразу понять, что с этим человеком вы работать не захотите.

Всегда есть, что усовершенствовать!

Однажды я выступал в роли наставника для девушки, которая хотела «войти в айти». Она показала мне маленькую игру, которую сама разработала. Но при этом она хотела подобрать себе новый проект, потому что этот был «закончен».

Проект никогда не может быть закончен. Всегда есть, что улучшить. Помните о первом правиле: качество важнее количества.

Если говорить более конкретно, то даже когда проект вроде бы завершен, вы все равно можете кое-что сделать. Например…

Добавить README.md

Файл README это начальная точка вашего проекта. Это первое, что видят люди!

Я думаю, такой файл должен быть в каждом репозитории. Даже если вы не хотите, чтобы люди интересовались вашим проектом, все равно можно добавить README и написать в нем: «Нечего здесь смотреть, листайте дальше!».

Ваш README должен отвечать на следующие вопросы:

  • О чем (для чего создан) этот проект? (1-2 предложений будет достаточно).
  • Как его установить?
  • Как им пользоваться?
  • Как это выглядит в готовом виде (в действии)? Можно добавить скриншот или gif-анимацию.

Совет. Для вдохновения можно изучить Awesome README repository.

Заняться маркетингом

Если вы создаете приложение — продвигайте его! Один мой бывший коллега создал минималистичный текстовый редактор. Этот разработчик не упускает случая опубликовать ссылку на свой проект в соцсетях (Twitter, LinkedIn…) и рассказать о том, что это за продукт и какие новые функции в него добавлены. Он также добавил этот свой редактор на ProductHunt/Reddit. Это отличные платформы для сбора отзывов!

Добавить новый функционал

Когда у вас на руках проект, созданный с нуля, вам будет совсем не трудно придумать, какие функции в него добавить. Если вы пробовали продвигать этот продукт или собрали отзывы друзей и родственников, у вас уже должен быть список идей.

На каком-то этапе вы можете дойти до точки, когда вам придется переосмыслить то, как вы написали свое приложение. Это отлично! Значит, вы уже прошли стадию «Hello world». Обычно по мере роста проекта начинают попадаться более интересные проблемы.

А еще…

  • Ведите список задач с использованием тикетов (или issues). Если у вас есть несколько тикетов, можете сгруппировать их по категориям: «баг», «улучшение»… И если люди обнаружат баг или захотят отправить запрос на новый функционал, они, возможно, откроют «issue» в вашем репозитории! Маленький совет: прежде, чем добавлять новый функционал, исправляйте все обнаруженные баги!
  • Пишите тесты! Многие рекрутеры, просматривая код, обращают внимание на наличие тестов. Напишите их для проекта, над которым работаете сейчас!
  • Добавьте непрерывную интеграцию (CI). Таким образом каждый раз при добавлении кода робот будет проверять, пройдены ли тесты и нет ли у вас «мертвого» кода. Здесь можно использовать такие инструменты как TravisCI или GitHub Actions.
  • Автоматизируйте развертывание. Многие инструменты позволяют осуществлять деплоймент в веб сразу при выполнении git push в ветку master. Обратите внимание на Netlify, GitHub/GitLab Pages, Vercel.
  • Сделайте ваше приложение доступным, чтобы им могли пользоваться люди с ограниченными возможностями.
  • Сделайте свое приложение mobile friendly (с отзывчивым веб-дизайном). Если с этим у вас не возникает проблем, попробуйте создать прогрессивное веб-приложение (PWA).
  • Как насчет монетизации? Если вы считаете, что ваш продукт решает проблему многих людей, стоит задуматься о монетизации. Этот проект может заработать вам на кофе (и не только)!

Запись Советы по улучшению GitHub-профиля впервые появилась Techrocks.

Источник: techrocks.ru

Обучение Работа primary

Читайте также


Как рынок страхования в России переживает пандемию, и почему маркетинг мог смягчить удар

SEO texterra.ru 23 октября 2020 г. 13:00
Снижение доходов населения, санкции, пандемия, жесткие меры регулятора – если задаться вопросом, можно найти с десяток причин, которые прямо сейчас вызывают турбулентность на рынке страхования в России. Конечно, хочется верить, что это временно: вот...... читать далее
Интервью

«У таргетолога нет выходных»: что это за профессия и зачем так работать

SEO ppc.world 23 октября 2020 г. 9:05
О рабочих обязанностях, профессиональных навыках, плюсах и минусах профессии из первых уст... читать далее
Мнения Рынок Другое

Разработка techrocks.ru 22 октября 2020 г. 19:17

В этой статье я поделюсь с вами впечатляющими работами, на которые я наткнулся, бродя по разным репозиториям на GitHub. Запись Примеры исходного кода, которые должен увидеть каждый разработчик впервые появилась Techrocks.... читать далее

Обучение primary

SEO texterra.ru 22 октября 2020 г. 14:00

Компания Google представила новую версию Google Analytics , в основе которой лежит «машинное обучение». Эта система открывает новые способы мониторинга и отслеживания ключевых тенденций, а значит у маркетологов и владельцев бизнеса появятся новые воз...... читать далее

Веб-аналитика

SEO ppc.world 22 октября 2020 г. 9:20

Оптимизируем рекламу застройщика во время пандемии... читать далее

Кейсы Google Ads

SEO texterra.ru 21 октября 2020 г. 13:00

Музыка эксплуатируется везде: в торговых центрах, частных клиниках, лифтах, туалетах; в роликах видеоблогеров; в рекламе, презентациях и прочих жанрах видеомаркетинга. Всем нужна музыка и желательно бесплатно. Ну ладно, по годовой подписке. Но чтобы...... читать далее

Бизнес

Безопасность Блог Касперского 21 октября 2020 г. 12:44

Тренинг по безопасности для системных администраторов и прочих продвинутых IT-специалистов.... читать далее

Enterprise SMB Бизнес облака облачная безопасность повышение осведомленности теневые IT тренинги

Популярные темы

ux (301) новости (265) design (253) новость (184) web dev (171) devops (169) ux-design (161) ubuntu (158) javascript (156) security (154) headline (136) python (122) tutorial (115) ui (104) статьи (99) user-experience (88) seo (80) testing roundup (79) programming (77) api5 (76) software testing (75) игровые проекты (75) java (73) дизайн (71) product-design (67) laravel (65) google (65) design-thinking (64) primary (64) working in tech (60) ui-design (59) технологии (57) windows 10 (57) прочее (57) uncategorized (53) дайджесты вакансий от new.hr (52) español (51) бизнес (47) турбо-страницы (47) движки и конструкторы игр (46) работа (45) web design and applications (45) мероприятия (44) навыки алисы (43) covid-19 (43) обучение (43) docker (43) technology (42) hardware (42) debian (41) publication (41) case-study (41) css (39) wp (38) home page stories (38) angular (38) chrome (37) machine learning (37) инструкции (37) aspnet (36) vue.js (36) kali linux (36) тестирование (36) полезное (36) cloud (36) android (35) networking (35) web (35) ux-research (34) art (33) навыки (33) google ads (33) data (33) wordpress (33) powershell (33) tutorials (32) inspiration (32) .net (31) windows (31) алиса (31) linux mint (30) интервью с экспертами (30) dotnet (30) creativity (29) api (29) apple (29) kubernetes (28) ios (28) без рубрики (28) bash programming (28) web-design (28) c# (28) job hunting (28) разработчики (27) industry (27) автоматизация (27) api4live (27) user-research (27) development (26) vmware (26)