Портфолио программиста

Работодатель смотрит портфолио пару минут. За это время он должен понять, что ты умеешь, как пишешь код и доводишь ли дело до конца. Лучше всего это показывают несколько законченных проектов с понятными README и честной историей работы.

Обновлено
В этой статье

Что положить в портфолио#

  • Два-три законченных проекта, а не десять заброшенных. Законченный —
    значит его можно запустить по инструкции и он делает то, что обещано.
  • Проект из реальной жизни — автоматизация своей задачи, бот, парсер,
    маленький сервис. Он интереснее учебного калькулятора.
  • Решённые задачи — если ты учился, покажи путь: репозиторий с
    задачами по темам и своими пояснениями.

README, который читают#

У каждого проекта в README:

  1. Одна фраза — что это и для кого.
  2. Скриншот или пример вывода.
  3. Как запустить — команды, которые работают с нуля.
  4. Что использовано и почему.
  5. Что бы ты сделал дальше.

Последний пункт многое говорит о тебе: ты видишь слабые места своей работы.

История коммитов — тоже портфолио#

Проект, выложенный одним коммитом «final», выглядит как скачанный.
Осмысленные коммиты за несколько недель показывают, как ты работаешь:
маленькие шаги, понятные сообщения, исправления после ревью. Веди историю
честно с первого дня — её нельзя убедительно дорисовать задним числом.

Профиль#

Страница профиля — первое, что откроют. На Skillok у профиля есть README —
короткий рассказ о себе, стек, ссылки на лучшие проекты — и календарь
активности, где видно, как регулярно ты работаешь. Открытые репозитории
показываются на профиле.

Учебный путь как преимущество#

Если ты только входишь в профессию, не прячь учёбу. Челленджи с
автоматической проверкой решений на Python и JavaScript, конспекты,
пройденные курсы — всё это лежит в репозиториях с датами и показывает
траекторию: что ты изучал и в каком порядке.

Частые ошибки#

  • копия учебного проекта из курса без изменений;
  • нет инструкции по запуску;
  • секреты и пароли в коде — проверь историю, а не только последнюю версию;
  • сорок репозиториев, из которых смотреть стоит два.

Попробовать на своей задаче

Создай репозиторий — история изменений, задачи и запросы на слияние будут с первого дня.

Создать репозиторий

Было полезно?

Ещё сценарии

СДО для сотрудников Классическая СДО — это курсы, назначения, отчёты и сертификаты. Skillok закрывает часть этих задач иначе — через репозиторий материалов, задачи-назначения и курсы с автопроверкой. Если тебе нужны отчёты по каждому сотруднику и совместимость со SCORM — честно скажем сразу, этого нет. Приложение для конспектов Хороший конспект нужно не только написать, но и перечитывать, дополнять и находить через год. Для этого подходят обычные markdown-файлы с формулами и схемами, разложенные по предметам и хранящие историю правок. Вот как вести конспекты у нас. Платформа для своего курса Если у тебя есть что объяснить и ты хочешь собрать курс, а не лендинг с оплатой, — можно начать бесплатно. Курс собирается из уроков и шагов с автоматической проверкой, а черновики материалов живут в репозитории с историей правок. Платформа для репетитора Урок длится час, а учёба идёт всю неделю. Skillok закрывает время между занятиями — материалы, домашние задания, проверку и историю прогресса ученика. Сразу честно — интерактивной доски и видеосвязи у нас нет, занятие проводи в привычном инструменте. LMS для небольшой команды Полноценная LMS — это десятки функций, большая часть которых небольшой команде не нужна. В Skillok учебная часть собрана из немногих вещей — курсы с автопроверкой, материалы с историей и задания с ревью. Ниже — что именно есть, чтобы ты решил, хватит ли этого. Личная база знаний Личная база знаний — это не архив всего прочитанного, а набор твоих собственных записей, связанных между собой, к которым ты возвращаешься. Разберём, как её устроить, чтобы она работала, а не превратилась в свалку ссылок.

Ещё темы

Программирование и IT Файл .gitignore В проекте всегда есть файлы, которым в репозитории не место — кэш, папки сборки, настройки редактора, локальные пароли. Список таких файлов держат в .gitignore, и git перестаёт предлагать их к добавлению. Школьная математика Задачи на проценты 6 класс Процент — это сотая доля: 1 % = 0,01. Почти все школьные задачи на проценты сводятся к трём типам, и каждый решается одним действием, если правильно определить, что в условии принято за целое. Как учиться Выгорание Эта статья — не о здоровье и не о том, как поставить себе диагноз. Она о рабочих и учебных условиях, при которых силы уходят быстрее, чем восстанавливаются, и о том, что в этих условиях можно изменить самому. Всё, что касается состояния организма, решает врач или психолог, а не текст в интернете.