Метки — это полезная функция GitHub, которая позволяет фильтровать проблемы и запросы на включение изменений. Они помогают найти что-то интересное для работы, соответствующее вашему уровню опыта.
В наших репозиториях добавление новых меток к задачам выполняется исключительно основной командой Blockly, чтобы гарантировать, что все не окажется в неправильном месте.
Размер
Некоторые проблемы небольшие и красивые, в то время как на решение других могут уйти недели. Эти метки помогут вам понять, сколько работы, вероятно, потребуется для решения той или иной проблемы.
- Хорошая первая проблема : эти проблемы отлично подходят для новичков в репозитории. Они займут меньше половины рабочего дня и не требуют глубоких знаний кодовой базы. Вы можете начать работу над этими проблемами немедленно, без одобрения команды.
Юрисдикция
Работа с широко используемым репозиторием может быть деликатным процессом, и некоторые проблемы могут быть более деликатными, чем другие. Эти метки помогут вам понять, какие проблемы открыты для обсуждения, а какие следует избегать.
- Требуется помощь : эти вопросы зарезервированы для участников. Часто это функции, которые основная команда считает полезными, но на их реализацию нет времени. Они могут потребовать обсуждения или реализации, поэтому проверяйте статус, чтобы узнать, какие работы требуются. Это хорошее место для поиска интересных творческих проектов!
- Внутренние : эти проблемы зарезервированы для членов основной команды. Часто это деликатные или сложные ошибки, требующие отдельного обсуждения. Лучше избегать их, поскольку ситуация вокруг них может быстро измениться!
- Ни то, ни другое : проблемы, не имеющие ни одного из этих ярлыков, могут быть исправлены участниками и членами основной команды. Если вы видите непомеченную проблему, которая кажется вам интересной, действуйте!
Статус
Некоторые задачи (особенно запросы на новые функции) проходят несколько стадий, прежде чем их можно будет считать закрытыми. Эти метки показывают, на какой стадии находится задача, и позволяют вам понять, что нужно сделать дальше.
- Обсуждение : Эти вопросы находятся на стадии обсуждения , а это значит, что перед реализацией ещё есть вопросы, на которые необходимо ответить. Если у вас есть какие-либо мысли по этому поводу, не стесняйтесь оставлять комментарии! Мы всегда рады вашим отзывам.
- Реализация : Эти вопросы достаточно хорошо обсуждались, чтобы быть чётко сформулированными и перейти в фазу реализации . Они либо ожидают реализации, либо уже реализуются. Если вы заинтересованы в работе над одним из них, прочитайте весь выпуск и оставьте комментарий, указав, над какой частью вы хотите поработать, а затем приступайте к работе!
- Ни то, ни другое : проблемы, не имеющие ни одного из этих ярлыков, могут находиться в любом из этих состояний. Если у вас есть мнение о том, как следует реализовать проблему, оставьте комментарий! Если же вы заинтересованы в работе над проблемой, лучше всего оставить комментарий с вопросом о её готовности к реализации.
Тип
Разные проблемы требуют разных ответов. Для решения некоторых проблем достаточно отредактировать несколько строк кода, а для решения других требуется много времени и обсуждений. Эти метки указывают, какие действия необходимо предпринять для решения проблемы.
- Ошибка : Эти проблемы указывают на проблему в кодовой базе. Часто для определения причины проблемы требуется отладка, но некоторые можно исправить мгновенно. Если вы любите глубоко копать и изучать, как работает код, эти проблемы вам очень пригодятся. Вы можете помочь, исправив ошибку или попытавшись разобраться в проблеме и написав понятное объяснение её первопричины.
- Запрос на новую функцию : эти задачи описывают функцию, которую кто-то хотел бы добавить. Это может относиться как к репозиторию в целом, так и к отдельному проекту. Если вы любите развивать идеи дизайна и добавлять новые функции, эти задачи могут вам идеально подойти.
- Вопрос : Эти проблемы документируют чей-то вопрос о кодовой базе. Обычно такие вопросы перенаправляются на форум разработчиков , но если вы видите вопрос, который, по вашему мнению, можете решить, не стесняйтесь ответить.
Категория
Этот репозиторий содержит несколько разных типов проектов, рассчитанных на разные целевые аудитории. Если вы увлекаетесь обучающими материалами или любите работать с плагинами, эти метки помогут вам найти интересующие вас темы.
- Codelab : Эти проблемы связаны с Blockly codelabs — набором интерактивных руководств.
- Пример : Эти проблемы связаны с примерами Blockly — набором самостоятельных демонстраций, демонстрирующих, как включать и расширять Blockly.
- Плагин : Эти проблемы связаны с плагинами Blockly — набором расширений, которые добавляют функциональность Blockly.
Проект
А если вам нужна ещё более точная информация, есть теги для отдельных проектов. Обычно они создаются для плагинов, с которыми, как правило, связано больше проблем, но их также можно создавать для кодовых лабораторий и примеров. Если вас интересует какой-то конкретный проект, эти теги помогут вам найти проблемы, связанные с ним.
Чтобы узнать, есть ли метка для интересующего вас проекта, просмотрите полный список меток:
Другой
Как и в любой коллекции вещей, здесь есть несколько необычных вещей, о которых вам стоит знать. Эти метки могут быть не так полезны, когда вы ищете проблему для работы, но всё же могут быть информативными.
- Приоритет : Эти проблемы ещё не были должным образом маркированы основной командой. Проблемы с этим ярлыком могут уже включать в себя другие простые ярлыки, например, «ошибка» или «запрос на новую функцию» , но, вероятно, вскоре будут добавлены и другие ярлыки.
- Дубликат : эти проблемы связаны с проблемой, запросом или вопросом, который уже рассматривается в другой проблеме. Этот тег указывает на то, что вам следует отвечать не на эту проблему, а на исходную.