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

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

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

Бэк: GraphQL RuboCop: добавить коп для проверки заполнения описаний типов

Для новичков, задача на пару дней

rubocop-graphql — Ruby gem, проверяющий на соответствие стилю код, использующий DSL graphql-ruby.

Необходимо реализовать коп ObjectDescription, проверяющий, что для всех типов (включая мутации, подписки, резолверы) заполнено описание (метод description).

Польза: научиться писать копы для rubocop, принести пользу Ruby–сообществу.

Одним из важнейших преимуществ GraphQL–систем является наличие неустаревающей документации. Это достигается благодаря существованию схемы — описания всех типов и связей между ними, которое также необходимо и для работы среды исполнения. Однако часто этого недостаточно, поэтому рекомендуется снабжать типы дополнительными описаниями:

class Types::UserType < Types::BaseObject
  description "Represents application user"
end

Постановка задачи

Необходимо реализовать коп, напоминающий о необходимости заполнения описания для типов:

class Types::UserType < Types::BaseObject
      ^^^^^^^^^^^^^^^ Missing type description
end

Советы по реализации

  1. Посмотреть, как реализован аналогичный коп FieldDescription (он проверяет, что у поля есть описание).
  2. Разобраться с node pattern — инструментом rubocop для работы с AST.

Инструкции по выполнению

  1. Обсудить задачу, если есть вопросы.
  2. Форкнуть проект rubocop-graphql на GitHub.
  3. Реализовать необходимый функционал и покрыть его тестами.
  4. Сделать Pull Request.