Настройка вашага праекта на поспех

Вы запусцілі свой праект, распаўсюджваеце інфармацыю, і людзі спрабуюць яго. Цудоўна! Як пераканаць іх застацца?

Дабразычлівая супольнасць-гэта інвестыцыя ў будучыню і рэпутацыю вашага праекта. Калі ваш праект толькі пачынае атрымліваць іншы ўклад, пачніце з таго, каб даць першым удзельнікам станоўчы вопыт, каб ім хацелася вяртацца.

Зрабіце так, каб людзі адчувалі сябе жаданымі гасцямі

Адзін са спосабаў думаць пра супольнасць вашага праекта, што @mikemcquaid называе варонка ўдзельнікаў:

Ствараючы сваё супольнасць, падумайце, як хто-то наверсе варонкі (патэнцыйны карыстальнік) тэарэтычна можа дабрацца да канца ўніз (Актыўны суправаджалы). Ваша мэта-паменшыць трэнне на кожным этапе ўзаемадзеяння з удзельнікам. Калі ў людзей лёгкія перамогі, яны будуць адчуваць стымул рабіць больш.

Пачніце з вашай дакументацыі:

• Палегчыце выкарыстанне вашага праекта для любога жадаючага.Сяброўская README і зразумелыя прыклады кода дапамогуць любому, хто зацікавіцца вашым праектам, пачаць працу.
• Растлумачце, як удзельнічаць, выкарыстоўваючы кіраўніцтва для ўдзельнікаў і аператыўна адказваючы на пытанні (issues).
• Добрыя першыя пытанні (issues): каб дапамагчы новым удзельнікам пачаць працу, відавочна разгледзьце цэтлікі пытанняў, якія досыць простыя для начинающих. затым GitHub выведзе гэтыя пытанні ў розных месцах платформы, павялічваючы карысны ўклад і памяншаючы трэнне карыстальнікаў, якія вырашаюць праблемы, якія занадта складаныя для іх ўзроўню.

Агляд адкрытага зыходнага кода GitHub за 2017 год паказаў, што няпоўная або заблытаная дакументацыя з’яўляецца самай вялікай праблемай для карыстальнікаў адкрытага зыходнага кода. Добрая дакументацыя падахвочвае людзей ўзаемадзейнічаць з вашым праектам. Урэшце, нехта адкрые пытанне ці пул-рэквест. Выкарыстоўвайце гэтыя ўзаемадзеяння як магчымасці для прасоўвання іх па варонцы.

• Калі хто-то новы трапляе ў ваш праект, падзякуеце яго за праяўлены цікавасць!** Дастаткова аднаго негатыўнага вопыту, каб хтосьці не захацеў вяртацца.
• Будзьце спагадныя. Калі вы не адказваеце на іх пытанне на працягу месяца, хутчэй за ўсё, яны ўжо забыліся аб вашым праекце.
• Будзьце адкрыты ў дачыненні да дапамогі, якую вы прымеце. Многія ўдзельнікі пачынаюць з справаздачы пра памылку або невялікага выпраўлення. Ёсць шмат спосабаў ўнесці свой уклад у праект. Дазвольце людзям дапамагчы так, як яны хочуць дапамагчы.
• Калі ёсць прапанова, з якой вы не згодныя, падзякуеце іх за ідэю і растлумачце, чаму яна не ўпісваецца ў рамкі праекта, даўшы спасылку на адпаведную дакументацыю, калі яна ў вас ёсць.

Большасць удзельнікаў адкрытага зыходнага кода з’яўляюцца» выпадковымі”: людзьмі, якія ўносяць свой уклад у праект толькі ад выпадку да выпадку. У выпадковага ўдзельніка можа не быць часу, каб цалкам асвоіць ваш праект, таму ваша задача - спрасціць для яго ўдзел.

Заахвочванне іншых удзельнікаў-таксама ўкладанне ў сябе. Калі вы дазваляеце сваім самым вялікім прыхільнікам займацца тым, чым яны захопленыя, становіцца менш неабходнасці рабіць усё самастойна.

Дакументуйце ўсё

Калі вы пачынаеце новы праект, можа здацца натуральным захаваць канфідэнцыяльнасць сваёй працы. Але праекты з адкрытым зыходным кодам квітнеюць, калі вы Публічна дакументуеце свой працэс.

Калі вы нешта запісваеце, больш людзей могуць удзельнічаць на кожным этапе шляху. Вы можаце атрымаць дапамогу ў тым, пра што нават не падазравалі.

Запіс азначае больш, чым проста тэхнічная дакументацыя. Кожны раз, калі вы адчуваеце жаданне запісаць што-небудзь ці абмеркаваць свой праект у прыватным парадку, спытаеце сябе, Ці можаце вы зрабіць гэта публічна.

Будзьце празрыстыя ў дачыненні да дарожнай карты вашага праекта, тыпаў укладаў, якія вы шукаеце, таго, як ацэньваюцца ўклады, ці чаму вы прынялі пэўныя рашэнні.

Калі вы заўважылі, што некалькі карыстальнікаў сутыкаюцца з той жа праблемай, задакументуйце адказы ў README.

Для сустрэч разгледзьце магчымасць публікацыі нататак або высноў па актуальным пытанні. Водгукі, якія вы атрымаеце ад такога ўзроўню празрыстасці, могуць вас здзівіць.

Дакументаванне за ўсё ставіцца і да вашай працы. Калі вы працуеце над істотным абнаўленнем свайго праекта, змесціце яго ў пул-реквест і адзначце як незавершанае (WIP). Такім чынам, іншыя людзі могуць адчуць сябе ўцягнутымі ў працэс на ранняй стадыі.

Будзьце спагадныя

Як вы прасоўваць свой праект, людзі будуць атрымліваць ад вас зваротную сувязь. У іх могуць быць пытанні, як усё працуе, альбо ім можа спатрэбіцца дапамога для пачатку працы.

Паспрабуйце аператыўна рэагаваць, калі хтосьці задае пытанне, адпраўляе запыт на перанос або задае пытанне аб вашым праекце. Калі вы адкажаце хутка, людзі адчуюць сябе ўдзельнікамі дыялогу і будуць з вялікім энтузіязмам удзельнічаць.

Нават калі вы не можаце адразу праглядзець запыт, своечасовае прызнанне яго дапаможа павысіць ўцягнутасць. Вось як @tdreyno адказаў на пул-реквест ў Middleman:

Даследаванне Mozilla паказала, что удзельнікі, чый код праверылі на працягу 48 гадзін, часцей вярталіся і рабілі паўторны ўклад.

Размовы пра ваш праект таксама могуць адбывацца ў іншых месцах у Інтэрнэце, такіх як Stack Overflow, Twitter або Reddit. Вы можаце наладзіць паведамлення ў некаторых з гэтых месцаў, каб атрымліваць іх, калі хтосьці згадвае ваш праект.

Дайце вашай супольнасці месца для сустрэч

Ёсць дзве прычыны, каб даць вашай супольнасці месца для сходаў.

Першая прычына для іх. Дапамажыце людзям даведацца адзін аднаго. Людзі з агульнымі інтарэсамі непазбежна захочуць пра гэта пагаварыць. А калі зносіны адкрыта і даступна, любы можа прачытаць мінулыя архівы, каб быць у курсе і пачаць удзельнічаць.

Другая прычына для вас. Калі вы не дасце людзям публічнае месца для абмеркавання Вашага праекта, яны, хутчэй за ўсё, звяжуцца з вамі напрамую. Спачатку можа здацца досыць простым адказаць на асабістыя паведамленні»толькі адзін раз”. Але з часам, асабліва калі ваш праект стане папулярным, вы адчуеце сябе знясіленым. Не паддавайцеся спакусе пагаварыць з людзьмі пра свой праект сам-насам. Замест гэтага накіруйце іх на прызначаны агульнадаступны канал.

Публічнае зносіны можа быць такім жа простым, як указанне людзям адкрыць праблему замест таго, каб пісаць вам напрамую або каментаваць ваш блог. Вы таксама можаце наладзіць спіс рассылання або стварыць уліковы запіс Twitter, Slack або IRC-канал, каб людзі казалі аб вашым праекце. Або паспрабуйце ўсё вышэйпералічанае!

Kubernetes kops кожныя два тыдні вылучае працоўныя гадзіны, каб дапамагчы ўдзельнікам супольнасці:

Копы таксама вылучаюць час раз у два тыдні, каб прапанаваць дапамогу і кіраўніцтва супольнасці. Суправаджаючыя копаў пагадзіліся вылучыць час, спецыяльна прызначанае для працы з пачаткоўцамі, дапамогі з PR і абмеркавання новых функцый.

Прыкметнымі выключэннямі з публічнага зносін з’яўляюцца: 1) праблемы бяспекі і 2) канфідэнцыйныя парушэнні Кодэкса паводзін. У вас заўсёды павінна быць магчымасць паведаміць аб гэтых праблемах у прыватным парадку. Калі вы не хочаце выкарыстоўваць асабістую электронную пошту, Стварыце спецыяльны адрас электроннай пошты.

Развіццё вашага супольнасці

Супольнасці надзвычай моцныя. Гэтая сіла можа быць дабраславеньнем або праклёнам, у залежнасці ад таго, як вы ёю валодаеце. Па меры росту супольнасці вашага праекта ёсць спосабы дапамагчы яму стаць сілай стварэння, а не разбурэння.

Не церпіце дрэнных удзельнікаў

Любы папулярны праект непазбежна прыцягне людзей, якія хутчэй шкодзяць, чым дапамагаюць Вашаму супольнасці. Яны могуць пачаць непатрэбныя спрэчкі, спрачацца аб трывіяльных асаблівасцях або запалохваць іншых.

Зрабіце ўсё магчымае, каб прыняць палітыку нулявой цярпімасці ў адносінах да гэтых тыпаў людзей. Калі пакінуць гэта без увагі, негатыўныя людзі створаць дыскамфорт іншым людзям у вашым супольнасці. Якія могуць нават сысці.

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

Калі вы бачыце негатыўнае паводзіны ў сваім праекце, Абвясьцеце пра гэта публічна. Растлумачце добрым, але цвёрдым тонам, чаму іх паводзіны непрымальныя. Калі праблема не знікне, вам можа спатрэбіцца папрасіць іх сысці. Ваш кодэкс паводзінаў можа быць канструктыўным кіраўніцтвам для такіх размоў.

Пазнаёмцеся з удзельнікамі там, дзе яны ёсць

Добрая дакументацыя становіцца толькі важней па меры росту вашага супольнасці. Выпадковыя ўдзельнікі, якія інакш могуць не быць знаёмыя з вашым праектам, чытаюць вашу дакументацыю, каб хутка атрымаць кантэкст, у якім яны маюць патрэбу.

У вашым файле CONTRIBUTING відавочным чынам паведаміце новым удзельнікам, як пачаць працу. Магчыма, вы нават захочаце стварыць для гэтай мэты спецыяльны раздзел. Django, напрыклад, мае адмысловую мэтавую старонку, каб вітаць новых удзельнікаў.

У чарзе задач пазначце памылкі, якія падыходзяць для розных тыпаў удзельнікаў: напрыклад, “толькі для пачаткоўцаў”, “як скласці першае пытанне”, або “дакументацыю”. Гэтыя ярлыки спрашчаюць хуткае сканаванне вашых пытанняў для пачаткоўцаў у вашым праекце, каб пачаць дзейнічаць.

Нарэшце, выкарыстоўвайце сваю дакументацыю, каб людзі адчувалі сябе жаданымі на кожным этапе шляху.

Вы ніколі не будзеце ўзаемадзейнічаць з большасцю людзей, якія трапляюць у ваш праект. Могуць быць ўклады, якія вы не атрымалі, таму што хтосьці спалохаўся ці не ведаў, з чаго пачаць. Нават некалькі добрых слоў могуць утрымаць кагосьці ад расчаравання.

Напрыклад, вось як Rubinius пачынае сваё кіраўніцтва:

Мы хочам пачаць, каб падзякаваць вас за выкарыстанне Rubinius. Гэты праект з’яўляецца плёнам любові, і мы цэнім усіх карыстальнікаў, якія вылоўліваюць памылкі, палепшыць прадукцыйнасць і дапамагчы з дакументацыяй. Кожны ўклад значны, таму дзякуй за ўдзел. Пры гэтым вось некалькі рэкамендацый, якім мы просім вас прытрымлівацца, каб мы маглі паспяхова вырашыць вашу праблему.

Сумеснае валоданне вашым праектам

Людзі рады ўносіць свой уклад у праекты, калі яны адчуваюць сваю датычнасць. Гэта не значыць, што вам трэба змяніць бачанне свайго праекта або прымаць непажаданыя ўклады. Але чым больш вы давяраеце іншым, тым больш яны застаюцца з вамі.

Паглядзіце, ці зможаце вы знайсці спосабы як мага больш Падзяліцца ўласнасцю са сваёй супольнасцю. Вось некалькі ідэй:

• Не паддавайцеся выпраўленню простых (некрытычных) памылак. Замест гэтага выкарыстоўвайце іх як магчымасці для прыцягнення новых удзельнікаў ці настаўніцтва тых, хто хацеў бы ўнесці свой уклад. Спачатку гэта можа здацца ненатуральным, але з часам вашы ўкладанні акупяцца. Напрыклад, @michaeljoseph папрасіў ўдзельніка адправіць пул-реквест па праблеме Cookiecutter, а не выпраўляць яе самому.

• Запусціце файл CONTRIBUTORS або AUTORS ў сваім праекце, у якім пералічаныя ўсе, хто ўнёс свой уклад у ваш праект, як, напрыклад, Sinatra.

• Калі ў вас ёсць вялікая супольнасць, разашліце бюлетэнь альбо напішыце паведамленне ў блогу * * з удзячнасцю ўдзельнікам. This Week in Rust ад Rust і Shoutouts ад Hoodie-два добрыя прыклады.

• Падайце кожнаму ўдзельніку доступ да камітаў. @felixge выявіў, што гэта прымусіла людзей з вялікім энтузіязмам адточваць свае патчы, і ён нават знайшоў новых суправаджаючых для праектаў, над якімі даўно не працаваў.

• Калі ваш праект размешчаны на GitHub, перамесціце яго з сваёй асабістай ўліковага запісу ў арганізацыю** і дадайце хоць бы аднаго рэзервовага адміністратара. Арганізацыі спрашчаюць працу над праектамі з вонкавымі суаўтарамі.

Рэальнасць такая, што у большасці праектаў ёсць адзін ці два суправаджаюць, якія робяць вялікую частку працы. Чым буйней ваш праект і чым больш ваша супольнасць, тым лягчэй знайсці дапамогу.

Хоць вы не заўсёды можаце знайсці каго-небудзь, хто адкажа на заклік, падача сігналу павялічвае шанцы, што іншыя людзі ўмяшаюцца. І чым раней вы пачнеце, тым хутчэй людзі змогуць дапамагчы.

Дазвол канфліктаў

На ранніх стадыях праекта лёгка прымаць важныя рашэнні. Калі вы хочаце нешта зрабіць, вы проста робіце гэта.

Калі ваш праект становіцца больш папулярным, усё больш людзей будуць цікавіцца вашымі рашэннямі. Нават калі ў вас няма вялікай супольнасці ўдзельнікаў, калі ў вашага праекта шмат карыстальнікаў, вы знойдзеце людзей, якія ўзважваюць рашэнні або падымаюць ўласныя праблемы.

Па большай частцы, калі вы стварылі прыязнае, паважлівае супольнасць і адкрыта задакументавалі свае працэсы, ваша супольнасць павінна знайсці рашэнне. Але часам вы сутыкаецеся з праблемай, якую крыху больш складана вырашыць.

Усталюйце планку дабрыні

Калі ваша супольнасць змагаецца з цяжкай праблемай, можа падняцца напал запалу. Людзі могуць раззлавацца або знервавацца і пакрыўдзіцца адзін на аднаго або на вас.

Ваша задача як суправаджальніка - не дапусціць абвастрэння падобных сітуацый. Нават калі ў вас ёсць цвёрдае меркаванне па тэме, паспрабуйце заняць пазіцыю мадэратара або фасілітатара, замест таго, каб уступаць у барацьбу і прасоўваць свае погляды. Калі хтосьці паводзіць сябе недобразычліва або манапалізуе гутарку, дзейнічайце неадкладна, каб абмеркаванне было ветлівым і прадуктыўным.

Іншыя людзі чакаюць ад вас савета. Падавайце добры прыклад. Вы па-ранейшаму можаце выказваць расчараванне, няшчасце або неспакой, але рабіце гэта спакойна.

Захоўваць сябе ў руках няпроста, але дэманстрацыя лідэрства паляпшае здароўе вашага супольнасці. Інтэрнэт дзякуе вас.

Ставіцеся да README як да Канстытуцыі

Ваш README-гэта больш, чым проста набор інструкцый. Гэта таксама месца, каб гаварыць аб вашых мэтах, бачанне прадукту і планах развіцця. Калі людзі занадта сканцэнтраваны на абмеркаванні вартасцяў той ці іншай функцыі, магчыма, будзе карысна вярнуцца да README і пагаварыць пра больш высокім бачанні вашага праекта. Засяроджванне ўвагі на README таксама абязлічвае размова, таму вы можаце весці канструктыўнае абмеркаванне.

Засяродзьцеся на падарожжы, а не на пункце прызначэння

У некаторых праектах для прыняцця важных рашэнняў выкарыстоўваецца працэс галасавання. Хоць на першы погляд гэта выглядае разумна, галасаванне робіць упор на пошуку “адказу”, а не на тым, каб выслухоўваць і вырашаць праблемы адзін аднаго.

Галасаванне можа стаць палітычным, калі ўдзельнікі супольнасці адчуваюць ціск, аказваючы адзін аднаму паслугі або прагаласаваўшы пэўным чынам. Не ўсе галасуюць, няхай гэта будзе маўклівае большинство у вашым супольнасці або карыстальнікі, якія не ведалі, што праходзіць галасаванне.

Часам галасаванне з’яўляецца неабходным умовай дазволу канфліктаў. Аднак, наколькі вы можаце, зрабіце ўпор на “пошуку кансенсусу”, а не на кансенсусе.

У працэсе пошуку кансенсусу члены супольнасці абмяркоўваюць асноўныя праблемы, пакуль не адчуюць, што іх належным чынам выслухалі. Калі застаюцца толькі нязначныя праблемы, супольнасць рухаецца наперад. “Пошук кансенсусу” прызнае, што супольнасць можа не прыйсці да ідэальнага адказу. Замест гэтага ён аддае перавагу слуханню і абмеркаванню.

Нават калі вы на самой справе не ўжываеце працэс пошуку кансенсусу, як суправаджалы праекта, важна, каб людзі ведалі, што вы іх слухаеце. Прымусіць іншых адчуць сябе пачутымі і што вы стараецеся вырашыць іх праблемы ў значнай ступені дапамагае пазбавіцца ад далікатных сітуацый. Затым падмацаваць свае словы дзеяннямі.

Не спяшайцеся з рашэннем дзеля дазволу. Пераканайцеся, што ўсе адчуваюць сябе пачутымі і што ўся інфармацыя адданая галоснасці, перш чым пераходзіць да вырашэння.

Засяродзьце размову на дзеянні

Абмеркаванне важна, але ёсць розніца паміж прадуктыўным і непрадуктыўным размовай.

Заахвочвайце абмеркаванне, пакуль яно актыўна рухаецца да дазволу. Калі ясна, што размова вялится або сыходзіць не па тэме, ўколы становяцца асабістымі ці людзі чапляюцца да дробязяў, пара яго закрыць.

Працяг гэтых размоў дрэнна не толькі для вырашэння разгляданай праблемы, але і для здароўя вашага супольнасці. Ён пасылае паведамленне пра тое, што такія размовы дазволеныя ці нават заахвочваюцца, і можа адштурхнуць людзей падымаць ці вырашаць будучыя праблемы.

З кожным заўвагай, зробленым вамі ці іншымі, пытайцеся сябе: ” як гэта набліжае нас да вырашэння?”

Калі размова пачынае распадацца, спытаеце групу: “якія крокі мы павінны распачаць далей?” , каб пераарыентаваць размову.

Калі размова відавочна нікуды не прыйдзе, няма выразных дзеянняў, якія трэба распачаць, або адпаведныя дзеянні ўжо былі зроблены, зачыніце праблему і растлумачце, чаму вы яе зачынілі.

Выбірайце бітвы з розумам

Кантэкст важны. Падумайце, хто ўдзельнічае ў абмеркаванні і як яны ўяўляюць астатнюю частку супольнасці.

Ці ўсё ў супольнасці засмучаныя або ўцягнутыя ў гэтую праблему? Ці гэта самотны Парушальнік спакою? Не забывайце браць пад увагу маўклівых членаў вашага супольнасці, а не толькі актыўныя галасы.

Калі праблема не адлюстроўвае больш шырокія патрэбы вашага супольнасці, магчыма, вам проста трэба прызнаць заклапочанасць некалькіх чалавек. Калі гэта паўтаральная праблема без выразнага рашэння, пакажыце на папярэднія абмеркавання па гэтай тэме і зачыніце галінку.

Вызначце, хто вырашае канфлікты ў грамадстве

Пры добрым стаўленні і выразным зносінах самыя складаныя сітуацыі адрозныя. Аднак нават у прадуктыўнай гутарцы могуць проста быць розныя меркаванні аб тым, як дзейнічаць далей. У гэтых выпадках вызначыце чалавека ці групу людзей, якія могуць вырашыць праблему.

Вырашальным фактарам можа быць асноўны суправаджалы праекта або невялікая група людзей, якія прымаюць рашэнне на аснове галасавання. У ідэале вы вызначылі сродак вырашэння канфліктаў і звязаны з ім працэс у файле GOVERNANCE, перш чым вам калі-небудзь прыйдзецца яго выкарыстоўваць.

Тай-брэйк павінен быць апошнім сродкам. Спрэчныя пытанні-гэта магчымасць для вашага супольнасці расці і вучыцца. Скарыстайцеся гэтымі магчымасцямі і выкарыстоўвайце сумесны працэс, каб знайсці рашэнне ўсюды, дзе гэта магчыма.

Супольнасць-гэта ❤️ адкрытага зыходнага кода

Здаровыя і квітнеючыя супольнасці кожны тыдзень марнуюць тысячы гадзін на распрацоўку праграмнага забеспячэння з адкрытым зыходным кодам. Многія ўдзельнікі паказваюць на іншых людзей як на прычыну працы - ці не працы-над адкрытым зыходным кодам. Даведаўшыся, як выкарыстоўваць гэтую сілу канструктыўна, вы дапаможаце камусьці атрымаць незабыўны досвед працы з адкрытым зыходным кодам.

На галоўную