Ярлыки выпуска

Ярлыки — это замечательная функция GitHub, которая позволяет фильтровать проблемы и запросы на включение. Они помогут вам найти что-то интересное для работы, соответствующее вашему уровню опыта.

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

Размер

Некоторые проблемы незначительны и красивы, в то время как на решение других могут потребоваться недели. Эти метки помогут вам определить, сколько работы, вероятно, потребуется для решения проблемы.

  • Хорошая первая проблема : эти проблемы отлично подходят для новичков в репозитории. Они должны занимать менее половины дня работы и требовать ограниченного знания базы кода. Вы можете начать работу над этими вопросами сразу, без одобрения команды.

Юрисдикция

Работа над широко используемым репозиторием может быть деликатным процессом, и некоторые вопросы могут быть более деликатными, чем другие. Эти метки помогут вам определить, какие вопросы открыты для участия, а каких следует избегать.

  • Требуется помощь : Эти вопросы предназначены для участников. Часто это функции, которые основная команда считает полезными, но у них нет времени на реализацию. Они могут нуждаться либо в обсуждении, либо в реализации, поэтому проверьте метку статуса, чтобы узнать, какая работа необходима. Это хорошее место для поиска интересных творческих проектов!
  • Внутренний : эти вопросы предназначены для членов основной команды. Часто это деликатные или сложные ошибки, требующие специального обсуждения. Лучше избегать их, потому что ситуация вокруг них может быстро измениться!
  • Ни один : проблемы, не имеющие ни одного ярлыка, могут быть исправлены участниками и членами основной команды. Если вы видите непомеченную задачу, которая кажется вам интересной, беритесь за нее!

Положение дел

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

  • Обсуждение : Эти вопросы находятся на стадии обсуждения , а это значит, что еще остались вопросы, на которые необходимо ответить до реализации. Если у вас есть какие-либо мысли по этому вопросу, не стесняйтесь оставлять комментарии! Мы всегда ищем дополнительную информацию.
  • Реализация : Эти вопросы достаточно обсуждены, поэтому они четко определены и перешли в фазу реализации . Они либо ждут реализации, либо уже реализуются. Если вы заинтересованы в работе над одним из них, прочитайте весь выпуск, а затем оставьте комментарий, указав, над какой частью вы хотите поработать, а затем приступайте к делу!
  • Ни один : проблемы, не имеющие ни одного ярлыка, могут находиться в любом состоянии. Если у вас есть мнение о том, как следует реализовать эту проблему, оставьте комментарий! В качестве альтернативы, если вы заинтересованы в работе над этой проблемой, лучше всего оставить комментарий с вопросом, готова ли она к реализации.

Тип

Разные проблемы требуют разных ответов. Некоторые требуют редактирования всего нескольких строк кода, а другие требуют тщательного проектирования и обсуждения. Эти метки сообщают вам, какие действия потребуются для решения проблемы.

  • Ошибка : эти проблемы документируют проблему с базой кода. Чтобы диагностировать причину проблемы, им часто требуется некоторая отладка, но некоторые из них можно исправить в мгновение ока. Если вам нравится копать глубже, чтобы узнать, как работает код, это будет для вас большой проблемой. Вы можете помочь, исправив ошибку или покопавшись, чтобы понять проблему и написать четкое объяснение основной причины.
  • Запрос на добавление функции . Эти проблемы документируют функцию, которую кто-то хотел бы добавить. Это может относиться как к репозиторию в целом, так и к отдельному проекту. Если вам нравится конкретизировать дизайнерские идеи и добавлять новые функции, это может быть идеальным решением для вас.
  • Вопрос : Эти проблемы документируют вопрос, который у кого-то есть о кодовой базе. Обычно эти вопросы перенаправляются на форум разработчиков , но если вы видите вопрос, с которым, по вашему мнению, могли бы помочь, не стесняйтесь присоединиться и ответить.

Категория

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

  • Codelab : Эти проблемы относятся к Blockly codelabs , набору интерактивных руководств.
  • Пример : эти проблемы относятся к примерам Blockly, набору автономных демонстраций, демонстрирующих, как включать и расширять Blockly.
  • Плагин : эти проблемы относятся к плагинам Blockly, набору расширений, которые добавляют функциональность Blockly.

Проект

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

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

Другой

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

  • Сортировка : эти проблемы еще не были должным образом обозначены основной командой. Проблемы с этим ярлыком могут уже включать в себя другой простой ярлык, например ошибка или запрос на добавление функции , но вполне вероятно, что вскоре будут добавлены и другие ярлыки.
  • Дубликат : эти проблемы документируют проблему, запрос или вопрос, который уже описан в другой проблеме. Эта метка сообщает вам, что вам не следует отвечать на этот вопрос, а следует ответить на исходный вопрос.