Citiți-l în: Español.
Menținerea unui pachet open source este o muncă plină de satisfacții, dar este și a lot a muncii. Viața și cariera se schimbă, interesele se schimbă și, uneori, pur și simplu nu ai timp sau energie pentru a continua să lucrezi la pachetul tău R (și este în regulă!). Când se întâmplă asta, unul dintre cele mai responsabile lucruri pe care le poți face pentru utilizatorii de pachete, şi pentru tine, este să caută în mod proactiv un nou întreținător sau co-întreținător.
„Cum recrutez un nou întreținător?” este o întrebare pe care o auzim foarte des la rOpenSci. De-a lungul anilor, i-am sprijinit pe autorii pachetelor rOpenSci prin această tranziție, ajutându-i să se conecteze cu potențiali menținători, să clarifice așteptările cu privire la rol și să facă transferurile mai ușoare și mai durabile.
În această postare, împărtășim sfaturi practice și strategii pentru a vă ajuta să găsiți oameni care pot contribui și eventual să preia pachetul dvs., pe baza a ceea ce am învățat prin sprijinirea întreținătorilor de pachete care fac parte din suita rOpenSci.
Începeți devreme
Cel mai bun moment pentru a începe să căutați un nou întreținător este cu mult înainte de a avea nevoie de unul, iar cel mai bun loc pentru a căuta un nou întreținător este printre colaboratorii existenți la pachetul dumneavoastră. Din acest motiv, este o idee bună să faceți planificarea succesiunii parte a strategiei dvs. de proiectare și întreținere a pachetului de la început.
Încurajăm autorii pachetelor să scrie o „Declarație privind ciclul de viață” pentru a descrie viziunea dumneavoastră pe termen mediu și lung despre întreținerea dezvoltării pachetelor. Acestea pot fi doar câteva propoziții într-un CONTRIBUTING.md sau README.md fișier care prezintă intențiile dumneavoastră de dezvoltare, inclusiv cât timp anticipați să mențineți pachetul. Chiar dacă viitorul este incert, acest lucru ajută la stabilirea așteptărilor pentru tine, precum și pentru potențialii contribuitori.
Faceți pachetul prietenos pentru colaboratori
Dacă doriți să atrageți contribuitori care pot deveni menținători pe termen scurt sau lung, pachetul dvs. trebuie să fie abordabil. Ghidul nostru pentru dezvoltatori conține un întreg capitol despre crearea pachetelor prietenoase pentru colaboratori și avem, de asemenea, un apel comunitar „Configurați pachetul pentru a promova o comunitate”. În esență, iată câteva puncte cheie de luat în considerare.
Întrebați-vă:
- Ar putea o persoană nouă să înțeleagă cum să construiască, să testeze și să elibereze acest pachet numai din depozitul dvs.?
- Există suficientă documentație pentru a face contribuția clară și prietenoasă?
Adăugarea sau îmbunătățirea regulilor de contribuție este o modalitate excelentă de a reduce barierele în calea cuiva care începe să se comporte ca un întreținător, chiar înainte de a-și asuma oficial rolul. Un bun CONTRIBUTING.md poate acoperi:
- Cum să configurați un mediu de dezvoltare.
- Preferințe flux de lucru: problemă înainte de o solicitare de tragere?
- Cum preferați să primiți PR-uri (de exemplu, o funcție pe Pull Request, trebuie să includă teste etc.).
- Stilul codului sau instrucțiunile de formatare.
- Orice teste și cum să le rulați.
- Orice notă de proces de lansare, inclusiv scripturi, fluxuri de lucru CI sau pași manuali pe care îi luați pentru a lansa o nouă versiune.
Cu cât te-ai documentat mai clar, cu atât va fi mai puțin greu pentru cineva să spună „da” menținerii.
În funcție de capacitatea dvs. de a face acest lucru, puteți, de asemenea, să investiți activ în contribuabili în creștere în mai multe moduri, de exemplu:
Aceste activități vă ajută să vă extindeți comunitatea de contribuitori și potențiali viitori menținători, dar vor fi cele mai eficiente dacă începeți cu mult înainte de predarea pachetului, când mai aveți mult timp și energie de investit.
Clarifică ce ești dispus (și nu) să faci
Potențialii menținători noi se vor întreba:
- Veți mai fi prin preajmă pentru întrebări?
- Veți păstra un anumit nivel de control sau vă predați complet? (adică cauți un co-menținător sau un nou întreţinător?
Fii explicit. De exemplu:
- „Voi ajuta și voi fi disponibil în timpul tranziției, dar plănuiesc să mă îndepărtez complet ca întreținător odată ce tranziția este finalizată.”
- „Predau complet întreținerea, dar sunt bucuros să răspund la câteva întrebări în timpul tranziției.”
- „Aș dori să predau complet și să mă îndepărtez din funcția de întreținător cât mai curând posibil.”
Stabilirea unor limite clare îi ajută pe alții să decidă dacă se oferă voluntari și previne neînțelegerile mai târziu.
Deschideți o problemă: „Se caută un nou întreținător”
Odată ce ați decis să căutați noi menținători sau co-menținători și cum plănuiți să vă implicați în proiect în viitor, comunicați acest lucru clar. Un prim pas vizibil este să deschideți o problemă în depozitul dvs. dedicată acestui subiect.
Creați o problemă cu un titlu clar, cum ar fi: „Se caută noi menținători”, „Se caută un nou întreținător”, „Bine ați venit” sau „Se caută colaboratori”.
În organism, puteți include:
- Ce nivel de întreținere este necesar (numai remedieri de erori, dezvoltare de caracteristici, documentație etc.).
- Ce cauți într-un nou colaborator/co-menținător:
- Familiaritate cu limba/ecosistemul?
- Experiență cu testarea sau CI?
- Confort cu lansarea de noi versiuni?
- Cum să-ți exprimi interesul (comentați problema, vă e-mail etc.).
- Orice cronologie ai în vedere pentru tranziție.
Opțional puteți și explica De ce faceți un pas înapoi (la un nivel înalt: timp, interes, schimbarea locului de muncă etc.).
Această problemă devine locul central pentru a discuta schimbările de proprietate și poate servi ulterior ca înregistrare publică a tranziției.
Problema pachetului rentrez „New Maintainer(i)” este un bun exemplu de conținut, resurse și conversație ulterioară.
Actualizați-vă README pentru a reflecta starea pachetului
README este celălalt loc pe care îl vor vedea mulți utilizatori. Adăugați o notă scurtă, foarte vizibilă lângă partea de sus, de exemplu:
⚠️ **Project status:** we are looking for a new maintainer. If you're interested in helping maintain this package, please see (this issue)(link-to-issue) or get in touch at (email protected).
Acest mesaj va:
De asemenea, puteți adăuga un „Starea proiectului” secțiunea din README care oferă puțin mai mult context (de exemplu, „modul de întreținere”, „funcții noi, puțin probabile fără noi menținători” etc.).
Luați legătura cu colaboratorii existenți și cu utilizatorii puternici
Cei mai buni candidați pentru noi întreținerii sunt adesea deja în apropiere:
- Persoanele care au depus PR-uri.
- Persoane care au depus probleme utile și detaliate.
- Oamenii pe care îi cunoști folosesc pachetul în munca lor.
Puteți:
- Trimiteți un e-mail sau un mesaj scurt și politicos către câteva persoane care au fost deosebit de active. Chiar dacă spun nu, s-ar putea să cunoască pe altcineva care s-ar potrivi bine.
- Dacă nu aveți un e-mail sau o altă modalitate de contact, etichetați contribuitorii direct în problema „Se caută un nou întreținător”, așa cum a făcut întreținătorul pachetului rentrez.
Anunțați-l unde sunt utilizatorii dvs
Acum că depozitul dvs. de pachete are mesaje clare și un loc în care să vă exprimați interesul și un mod clar de a comunica cu dvs., este o idee bună să răspândiți cuvântul dincolo de depozitul dvs.
Luați în considerare postarea unui anunț scurt în locurile în care utilizatorii sau colaboratorii dvs. sunt probabil să îl vadă:
- Forumuri comunitare, liste de corespondență, canale Slack/Discord relevante pentru limba/ecosistemul dvs.
- Rețelele sociale (de exemplu, Mastodon, Bluesky, LinkedIn) folosind hashtag-uri specifice, cum ar fi #RStats.
De exemplu, rOpenSci listează problemele „Noi întreținători” pe site-ul nostru web, le distribuim pe rețelele noastre sociale și în buletinul nostru informativ.
Adăugați un mesaj de pornire a pachetului
La un moment dat, puteți lua în considerare adăugarea unui mesaj de pornire care informează utilizatorii despre căutarea întreținătorului.
În acest mesaj, puteți trimite la problema „Se caută un nou întreținător” și puteți încuraja utilizatorii să o verifice dacă sunt interesați să ajute.
Aceasta este o mișcare agresivă și poate enerva unii utilizatori, așa că luați în considerare doar dacă pachetul dvs. are mulți utilizatori activi și nu ați avut prea mult noroc să găsiți un nou întreținător prin alte canale.
Ultima soluție: arhivați pachetul
Înainte de a vă arhiva pachetul, acordați-vă timp pentru a adăuga un comentariu explicativ în toate problemele și PR și pentru a le închide pe toate. Puteți crea un nou README pentru a explica noul statut. Puteți adăuga cum să intrați în contact cu dvs. în cazul în care cineva ar dori să revigoreze depozitul și să se ocupe de întreținere.
Poate că software-ul dvs. va fi înlocuit cu alte pachete, poate cineva va ajunge să vă contacteze pentru a vă cere să transferați depozitul la ei, poate cineva va crea un înlocuitor cu același nume (și sperăm să corecteze autoritatea și licențele dacă vă reutiliza codul). În toate cazurile, veți fi făcut tot posibilul și soarta pachetului R este din mâinile voastre.
Este în regulă să dai înapoi
Renunțarea la menținerea unui pachet este o parte normală a ciclului de viață open source.
De:
- Faceți planuri pentru succesiune de la început,
- Faceți pachetul prietenos pentru colaboratori,
- Clarificarea propriilor limite,
- Deschiderea unei probleme clare „Căutarea unui nou întreținător”,
- Actualizează-ți README,
- Adresându-se colaboratorilor,
- Anunțând căutarea pe canalele potrivite,
- și dacă este necesar, arhivarea pachetului dvs.
oferiți proiectului dvs. cea mai bună șansă de a continua, respectând în același timp propriul timp și energie.
Ai alte sfaturi sau idei? Vă rugăm să le împărtășiți. Ne-ar plăcea să știm!
