Нам нужны твои мозги

Хотите расти как разработчик и найти крутую работу? Не протирайте штаны — займитесь Open Source проектами. Так легче всего попасть в лучшие команды разработчиков и положить себе в резюме настоящий проект, вместо нелепых «примеров кода». Но найти подходящий проект для участия сложно. Начинаются лень и отговорки, а за ними — отсутствие профессионального роста, критики по-настоящему крутых программистов, уныние и застой.

На Cult of Martians мы собираем интересные задачи для современных веб-программистов. Можно выбрать подходящую по сложности, продолжительности и специализации. Задачи не выдуманы «из воздуха» — каждая решает насущную проблему, и решить ее можно через создание нового Open Source проекта или улучшение существующего. Решайте задачи, прокачивайтесь, присылайте решение на оценку. Лучших могут пригласить к себе на работу компании, программистам которых понравится ваше решение.

Фронт: Доделать тему documentation-theme-light для Documentation.js

Для новичков, задача на неделю

Documentation.js — прекрасная замена мертвому JSDoc. Но все темы для него довольно плохие.

Самое грустное, что для проекта сделали отличную тему documentation-theme-light, но она не закончена.

Нужно добавить JS-скрипты генерации HTML и, опционально, чуть отполировать тему.

Польза: задача идеальна для CSS-разработчиков, которые хотят прокачаться в JavaScript.

  1. Создать новый проект с именем documentation-theme-light. Создать package.json и LICENSE по примеру Nano ID.
  2. Изучить, как делать темы для documentation.js.
  3. Изучить JS-скрипты, которые генерируют HTML в базовой теме.
  4. Изучить HTML примера, собранного с невыпущенной теме.
  5. Изучить стили невыпущенной темы.
  6. Скопировать все нужные файлы с невыпущенной темы и закоммитить их через git commit -m "Copy from unreleased documentation-theme-light" --author="Maya Oppa <mayagao@users.noreply.github.com>". Это сохранит авторство.
  7. Скомбинировать все выше и сделать новую тему на основе стилей невыпущенной темы.
  8. Удалить лишние файлы шрифтов. Нужен только woff2.
  9. Можно дополнительно прокачать мобильную версию.
  10. Попробовать применить эту тему для какого-то проекта (можно взять Nano ID и запустить там npx documentation *.js -f html -t ../documentation-theme-light -o docs).
  11. Создать README.md, где указать оригинального автора и как использовать тему.
  12. Прислать ссылку на проект на andrey@sitnik.ru или @sitnik.