В ответах « Что такое каноническая реплика:« Это открытый исходный код, отправьте патч »? Многие люди высказывали мнение, что просто просить людей представить патч высокомерно и грубо.
Но мне кажется, что как разработчик любого проекта с открытым исходным кодом, вы увидите намного больше запросов функций в списке рассылки, чем могли бы реализовать. Поэтому, когда пользователь говорит: «Я хотел бы увидеть функцию X», правда в том, что шансы на его реализацию довольно малы, если он сам не отправит патч. Кроме того, иногда все, что нужно для того, чтобы превратить пользователя в участника, может быть немного поощрения.
С другой стороны, вы не хотите отпугивать (потенциальных) участников, выступая как грубый.
Итак, как бы вы сказали «пожалуйста, отправляйте патчи вместо того, чтобы запрашивать функции» по-дружески?
Обновление: спасибо за все предложения! Я вижу, что большинство из них требуют довольно длинных объяснений. Но так как я предпочел бы избегать (а) объяснения одного и того же через день (это занимает слишком много времени) или (б) использования фрагментов, которые я вставляю в электронную почту (это очень быстро становится безличным), мне интересно: кто-нибудь написал это в документе, на который я могу сослаться?
(Специфичные для проекта вещи, такие как, как писать тесты, компилировать код и отправлять патч, все же, конечно, должны быть задокументированы, но я думаю, что эти технические проблемы должны все равно войти в CONTRIBUTING.txt.)
источник
Ответы:
Вы не
Насколько я знаю, кандидаты в соучастники являются тинкерами, и не будут отправлять запрос на добавление функции, просто запросив его. Обычно они запрашивают это с некоторым уровнем участия:
Программисты, которые отправляют запрос на функцию, обычно делают это по какой-то причине. Некоторые из них включают (и я точно знаю, что последние два происходят в WordPress, например):
Более типично, запросы функций будут поступать от конечных пользователей, которые не могли внести исправление, даже если бы захотели. Особенно когда подано за пределами системы продажи билетов.
Я думаю, что ваш самый важный приоритет должен состоять в том, чтобы не откладывать потенциальных / существующих участников, а не пытаться активно привлекать новых. Это очень важно, и я говорю это по опыту. У меня есть странный способ подобрать новую базу кода, которая включает в себя беглое чтение кода, чтобы получить некоторый уровень его понимания, переход в систему создания билетов и исправление легко выглядящих ошибок, чтобы глубоко изучить внутреннее устройство (и заполнить новые, как я тестирую). За эти годы я затопил несколько проектов с десятками билетов и патчей. Много раз этим билетам будет уделено мало или вообще никакого своевременного внимания (даже не подтверждение, например, продолжайте в том же духе!), В том числе когда они сопровождаются документированными этапами диагностики и приложенными модульными тестами.
источник
Короче говоря, вы объясняете, что у вас нет неограниченного времени, чтобы делать свою работу бесплатно. (Вы можете пропустить часть «бесплатно»), и они могут внести свой вклад в любое время, когда они захотят, это не «ваш» проект, а проект каждого.
так что вы говорите: «Мы очень сожалеем, это отличная идея, но мы слишком заняты всей другой работой, мы добавим ее в список, но если вы действительно хотите это включить, и вы хотели бы помочь нам, внеся свой вклад в проект, тогда это было бы замечательно. У нас есть некоторая документация, чтобы помочь ребятам внести изменения в проект, они здесь, так что если у вас есть навыки и время и хотите помочь нам, тогда, пожалуйста, отправьте нам патч с вашими изменениями. Возможно, нам придётся внести в него некоторые модификации, чтобы он соответствовал стандартам проекта, но вы будете делать нам большое спасибо, по крайней мере, предоставив нам поддержку для этой работы, и мы будем любить вас за помощь ».
Конечно, как только вы начнете просить патчи, вы никогда не сможете оставлять их в своей системе тикетов слишком долго, если вы получаете много, вы будете интегрировать их больше, чем выполняете работу, к которой вы привыкли. Возможно, вам это не понравится, но это необходимо, если вы хотите, чтобы патчи продолжали появляться.
источник
Будьте вежливы и объясните ситуацию ясно. Как насчет чего-то вроде:
Видите, вы не можете просто сказать: «Почему вы мешаете мне с вашими запросами? Я здесь не для того, чтобы работать на вас бесплатно; если вы хотите эту функцию, иди и реализуй ее самостоятельно». Человек может быть не разработчиком, может не знать язык, используемый для разработки продукта и т. Д.
Поэтому вместо того, чтобы быть грубым, вы можете предложить принять участие в проекте, а также объяснить, почему вы не можете реализовать эту функцию самостоятельно.
Еще один способ не быть грубым - не говорить ничего. Если у вас есть веб-сайт, на котором пользователи вашего приложения могут предлагать новые функции и сообщать об ошибках, вы можете отсортировать элементы по их приоритету: например, если функция запрашивается 10 000 пользователей, а другая - только 10 Есть вероятность, что первый будет реализован первым.
На таком веб-сайте вы всегда можете разместить предложение «реализовать сами» для функций, которые через несколько дней или недель не получили достаточного количества голосов других пользователей.
источник
Неужели это было так сложно?
источник
Что ж, вместо того, чтобы просто сказать «представь патч», тебе стоит немного подробнее рассказать.
источник
Вот что я обычно говорю ...
источник
В дополнение к хорошим способам сказать «Отправить патч», также предоставьте документацию, ориентированную на разработчика, чтобы другие, кому действительно нужна эта функция, могли быстро освоить ваш проект. Многие проекты не являются дружественными для разработчиков и требуют дней, чтобы как минимум прочитать тысячи строк кода и множество небольших тестовых примеров, которые выискивают в разных частях системы, чтобы получить правильные результаты.
Если вы предоставите помощь возможным разработчикам, они будут более чем готовы оказать помощь. Это означает хорошую документацию по коду, хорошие вики-страницы, объясняющие процесс (или хорошую диаграмму UML / whiteboard), и простой способ получить исправления.
источник
Мне действительно нравится то, как github побуждает других раскошелиться на проект. Несколько версий одного и того же проекта могут существовать под разными учетными записями пользователей. Если вам не нравится направление, в котором я веду проект, пожалуйста, раскошелитесь. Вы можете легко отправлять запросы, но не застреваете, ожидая, что я приму их.
Так что мой ответ часто, просто раскошелиться.
источник