Styring¶
De travle bier i Core Team har en række ansvarsområder for at holde BeeWare-bikuben i gang. Dette er et projekt under udvikling, så denne side kan ændres.
Disse omfatter, men er ikke begrænset til, at svare på spørgsmål, gennemgå og sammenlægning af kode, vejledning af nye bidragydere og arkitektur for BeeWare-projektet som helhed.
Der er folk, vi stoler på til at træffe kodebeslutninger; der er folk, vi stoler på til at træffe beslutninger om kode og organisation; og der er en person der styrer hele organisationens vision, og som er betroet at træffe den endelige træffe en endelig beslutning, hvis fællesskabet ikke kan nå til enighed.
Teamets anciennitet¶
De forskellige niveauer af anciennitet i BeeWare-projektet er:
Bi eller arbejderbi¶
Ethvert medlem af BeeWare-fællesskabet. Da vi arbejder åbent på GitHub, kan alle foreslå ændringer til koden og få deres kode flettet sammen. Den eneste begrænsning for din mulighed for at bidrage er, at dit arbejde skal flettes sammen af et teammedlem, der har rettighederne til at gøre det.
Biavler¶
En bi, der er blevet anerkendt som en pålidelig bidragyder. Disse bier har over en periode vist deres evner i relation til en bestemt del af BeeWare-projektet. Dette kan være på et teknisk niveau (JavaScript, Python, Objective-C-ekspertise; GTK+, macOS-viden) eller på et andet niveau (community management, kodegennemgang). Biavlere kan også have commit-bit for det projekt, hvor deres ekspertise er anerkendt.
Erfarne biavlere¶
Biavlere med forhøjet adgang i GitHub og et ekstra ansvar for at overvåge projektet som helhed. De kan træffe arkitektoniske beslutninger, men er i sidste ende ansvarlige over for BDFN.
Bee-nevolent Dictator for Now (BDFN)¶
En fortolkning af Benevolent Dictator for Life, ansvaret for projektets retning og beslutninger ligger i sidste ende hos BDFN. Brugen af "For Now" i modsætning til "For Life" er en henvisning til Djangos tema om ikke at pålægge en person ansvaret som kernevedligeholder for hele vedkommendes liv. Livet eksisterer uden for open source, og balancen mellem kode og liv samt generelt velbefindende er meget vigtigt at huske på.
BDFN for BeeWare er Russell Keith-Magee.
Grundlægger af biavl¶
Den mand, der først stod på en bakke og så en yak, der trængte til at blive barberet. Denne rolle ændrer sig aldrig og fortsætter i det uendelige, men den giver ikke i sig selv nogen ekstra magt i organisationen. I øjeblikket er den stiftende biavler også BDFN, men dette kan ændre sig med tiden.
Retningslinjer (ikke egentlige regler)¶
Som med ethvert projekt med mere end én person med commit-rettigheder er der er der en række generelle retningslinjer, som teamet bør følge:
- Vær en god repræsentant for projektet over for det bredere samfund
- Behandl alle henvendelser og bidrag til BeeWare-projekter med respekt
- Antag, at alle har gode intentioner, selvom de ikke har valgt deres ord med omhu.
- Antag, at hvis nogen har gjort noget på den "forkerte" måde, er det fordi vi har fejlet i at kommunikere processen.
- Antag, at ethvert udtryk for vrede eller frustration kommer fra et ægte ønske om at bruge et BeeWare-værktøj/bibliotek.
- Opfordre andre medlemmer af fællesskabet til at afspejle disse idealer i deres egen kommunikation, både inden for og uden for BeeWare-fællesskabet.
- Ingen biavler bør forpligte sig til sin egen kode
- Undtagelse: "Der er noget, der er meget ødelagt og skal repareres nu"
- Undtagelse: BDFN (dette kan ændre sig i fremtiden)
- Al kode, der indsendes til gennemgang af et kerneteammedlem, skal gennemgås af et andet teammedlem.
- Undtagelse: BDFN (dette kan ændre sig i fremtiden)
- Al kode skal bestå kontinuerlige integrationstests, før den flettes sammen.
- Undtagelse: kode, der vides at være defekt og skal committeres af andre årsager
- Undtagelse: kode i et repo med utilstrækkelige CI-tests
- Undtagelse: At arbejde og være engageret er bedre end at være perfekt og ikke gøre noget.
- Accepteringsprocesser bør automatiseres, hvor det er muligt.
- Det betyder test, linting, stavekontrol, dækning og meget mere.
At blive biavler¶
Introduktion af en ny biavler i teamet sker efter eget skøn af det eksisterende kerneteam. Selvom der i øjeblikket ikke er nogen faste regler for dette, vil nogen generelt blive inviteret til at være apiarist på et BeeWare-projekt, hvis de har demonstreret solide bidrag til projektet. projektet. Dette kan også udvides til en person med specifik domæneviden domæneviden (for eksempel iOS/macOS), som måske mangler i det eksisterende team. Det behøver heller ikke at være baseret på commits. Enhver, der er i stand til at demonstrere en interesse i projektet generelt, kan bede om at få tilladelse til at committe til projektet.
Alle nye biavlere vil blive 'indviet' (i mangel af et bedre ord) i projektets kerneværdier og retningslinjer. Et resumé af kerneværdierne kan findes på siden Om os. Alle, der tilslutter sig teamet, forventes at overholde disse værdier og bidrage til diskussioner om udviklingen af disse værdier over tid.
En biavler, ny eller gammel, forventes ikke at være den eneste, der vedligeholder nogen som helst ting. Der er mange biavlere og mange flere ved siden af, som kan tilbyde hjælp, rådgivning og mentorskab.
"Commit bit"?¶
I Unix-systemer bruges en enkelt bit i en fil til at angive tilladelse til at udføre en fil. I kildekontrolsystemer findes en lignende bit til at til at angive muligheden for at flette kode. At sige, at nogen har "commit bit" betyder, at de har skriveadgang til en kodebase. I GitHub-termer betyder det at de har mulighed for at flette Pull Requests og committe kode direkte til projektet.