Вчера, 17 февраля, команда разработчиков Github анонсировала новый функционал, которого пользователям, участвующим в групповой разработке, могло серьезно недоставать: теперь в GitHub есть шаблоны для Issue и Pull-реквестов.

image

По словам Бена Блейкампа "это первое из многих улучшений Issues и Pull-реквестов, сделанных благодаря фидбеку наших пользователей".

Для добавления шаблона Issue в репозиторий достаточно создать файл с именем ISSUE_TEMPLATE в корневом каталоге. Расширение файла роли не играет, но поддерживаются Markdown-файлы (.md). Это существенный плюс, так как md-разметка позволяет быстро и легко форматировать текст, добавлять ссылки, заголовки и списки задач.

Шаблон для Pull-реквеста добавляется по тому же принципу: создание файла с именем PULL_REQUEST_TEMPLATE в корневой директории вашего репозитория.

Для тех, кто опасается бардака в корневом каталоге была добавлена поддержка папки .github/. В ней можно с чистой совестью разместить файлы CONTRIBUTING.md, ISSUE_TEMPLATE.md и PULL_REQUEST_TEMPLATE.md и все будет работать в лучшем виде. Если не работает, то можно почитать мануалы.

Комментарии (25)


  1. MTonly
    18.02.2016 18:30
    +14

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


    1. meta4
      18.02.2016 18:42

      И отправку изменений из форка в оригинал одной кнопкой.


      1. geakstr
        18.02.2016 19:15
        +6

        Хм, разве кнопка «New pull request» не про это? Там два клика сделать


      1. MTonly
        18.02.2016 23:10
        +1

        В обратном направлении одной кнопкой не получится — нужно же ещё суть изменений изложить. ;-)

        Хотя, пожалуй, тоже есть что улучшить: несколько неинтуитивно, на странице какого из вариантов проекта (основного или форка) нажимать кнопку «New pull request» для отправки запроса на применение изменений из форк-проекта к основному проекту. В случае, когда это происходит относительно редко, каждый раз приходится строить предположение, что, наверное, следует использовать кнопку на странице основного проекта. Возможно, имело бы смысл по умолчанию отображать кнопку «New pull request» только на странице основного проекта, или на всех версиях проекта сделать её ведущей на одну и ту же информативную страницу, или хотя бы добавить самой кнопке всплывающую подсказку.


    1. Lol4t0
      19.02.2016 10:32
      +2

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


      1. aivus
        19.02.2016 11:22
        +3

        Хотелось бы делать это fast-forward'ом, а не мержкоммитом.


      1. MTonly
        19.02.2016 20:35

        Да я как бы в курсе. ;-)
        Просто слишком много ненужных действий для одной из наиболее фундаментальных операций.


  1. AnthonyBY
    18.02.2016 18:43
    +1

    У Bitbucket данный функционал очень хорошо реализован


  1. RubaXa
    18.02.2016 19:12
    +3

    Ну наконец-то!


  1. AllSeeingEye
    18.02.2016 20:35
    +1

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

    сделанных благодаря фидбеку

    сделанных благодаря отзывам


    1. ragequit
      18.02.2016 20:48
      +4

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


  1. Nagg
    18.02.2016 20:53
    +14

    Жду голосование для Issues, а то сейчас люди для этого пишут новые комментарии вида "+1" :(.


    1. ragequit
      18.02.2016 21:12
      -6

      А разве Markdown не позволяет его сделать?


      1. dirtyHabrBobr
        18.02.2016 22:54
        +5

        Что-что не позволяет сделать маркдаун?


        1. ragequit
          19.02.2016 12:15

          Возможно, я не правильно понял, но ведь markdown же позволяет создавать голосование. Или вы о голосовании нужно ли создавать Issue или нет?


          1. iroln
            19.02.2016 12:53

            Голосование за issue. Аналог votes в YouTrack, если так будет понятнее. Количество голосов определяют ценность issue для сообщества. Сейчас для этого все пишут комментарий "+1".


            1. grossws
              19.02.2016 12:56

              Часть +1 — это subscribe от тех, кто ниасилил в кнопку.


              1. iroln
                19.02.2016 12:59
                +3

                subscribe — не очевидно. Подписываются обычно те, кому нужно следить за issue. А я может не хочу следить и получать оповещения, я хочу просто проголосовать.


                1. grossws
                  19.02.2016 13:33
                  +1

                  Я имею ввиду, что есть несколько разных задач (голосование за issue/pr, подписка на обновления), которые люди пытаются решать имеющимися средствами. Из-за отсутствия отдельного механизма голосования за issue люди используют "+1" для двух задач одновременно. А потом, по инерции используют "+1" как способ подписаться на обновления, что очень засоряет почту.

                  Правда, наличие отдельного механизма для голосования за тикеты не спасло youtrack и они сделали workflow (мини-плагин), который трактует комментарии "+1", как vote.


                  1. iroln
                    19.02.2016 13:38

                    Про плагин для youtrack не знал. :)

                    Я думаю, им кроме плагина нужно сделать удобный интерфейс, где кнопка "Vote" была бы "большой и зелёной", а не маленькой серой незаметной иконкой где-то в углу страницы. Может её просто не замечают. Я думаю, что многие пользователи их IDE-продуктов видят этот их youtrack в первый раз.


            1. ragequit
              19.02.2016 13:22

              Теперь понял, спасибо.


    1. KvanTTT
      19.02.2016 00:02
      +1

      Да, было бы неплохо. Это все же тоже социальная сеть. К тому же люди будут чаще кликать, чем писать +1, что поднимет мотивацию разработчиков реализовать эту issue.


  1. narma
    19.02.2016 00:31
    +7

    Не лишним было бы упомянуть, что это первый шаг GitHub в качестве реакции на это публичное письмо: https://github.com/dear-github/dear-github
    Также Salvatore Sanfilippo лишний раз пинганул в твиттере гитхаб, чтобы те разродились ответом.


    1. iroln
      19.02.2016 02:26
      +2

      Сначала они извинились за то, что так медленно реагируют на просьбы
      http://www.infoworld.com/article/3033039/application-development/github-apologizes-for-ignoring-community-concerns.html


      1. narma
        19.02.2016 09:49
        +2

        Все верно, извинение прилетело аккурат после твита Сальваторе в виде Pull Request-а в репозиторий публичного письма.