Řízení projektu¶

Pilné včely z hlavního týmu mají řadu povinností, aby úl BeeWare fungoval. Projekt se vyvíjí, a tato stránka se proto může měnit.

Patří sem například reakce na nahlášené problémy, kontrola a slučování kódu, mentoring nových přispěvatelů a celková architektura projektu BeeWare.

Některým lidem důvěřujeme při rozhodování o kódu, jiným při rozhodování o kódu i organizaci. A pak je tu člověk, který určuje směr celé organizace a rozhoduje s konečnou platností, pokud komunita nedosáhne shody.

Seniorita týmu¶

Úrovně rolí v projektu BeeWare jsou:

Včela neboli dělnice¶

Kterýkoli člen komunity BeeWare. Vzhledem k tomu, že pracujeme otevřeně na GitHubu, může kdokoli navrhnout změny v kódu a nechat svůj kód začlenit. Jediným omezením vaší schopnosti přispívat je to, že vaše práce musí být začleněna členem týmu, který k tomu má oprávnění.

Včelař¶

Včela, která získala uznání jako důvěryhodný přispěvatel. Tyto včely po určitou dobu prokazovaly schopnosti v konkrétní části projektu BeeWare. Může jít o technickou oblast (znalost JavaScriptu, Pythonu či Objective-C; znalost GTK+ nebo macOS) nebo jinou oblast (správu komunity, revize kódu). Včelaři mohou mít také oprávnění zapisovat změny do projektu, v němž byla uznána jejich odbornost.

Zkušení včelaři¶

Včelaři s rozšířeným přístupem na GitHubu a také s větší odpovědností za dohled nad projektem jako celkem. Jsou schopni činit architektonická rozhodnutí, ale v konečném důsledku se zodpovídají BDFN.

Dobrotivý včelí diktátor prozatím (BDFN)¶

Podle konceptu Benevolent Dictator for Life nese odpovědnost za směřování a rozhodnutí projektu v konečném důsledku BDFN. Použití výrazu „prozatím“ namísto „na doživotí“ odkazuje na téma Django, které spočívá v tom, že odpovědnost správce jádra není vázána na celý život dané osoby. Život existuje i mimo open source a je velmi důležité mít na paměti rovnováhu mezi kódováním a životem a obecné blaho.

BDFN projektu BeeWare je Russell Keith-Magee.

Zakládající včelař¶

Muž, který jako první stál na kopci a zahlédl jaka, který potřeboval ostříhat. Tato role se nikdy nemění a trvá donekonečna; sama o sobě však nedává žádné další pravomoci v organizaci. V současnosti je zakládající včelař také BDFN, to se ale může časem změnit.

Zásady (nikoli skutečná pravidla)¶

Stejně jako u každého projektu, kde má práva ke commitování více lidí, i zde tým dodržuje několik obecných zásad:

Buďte dobrým zástupcem projektu vůči širší komunitě
Ke každému dotazu a příspěvku k jakémukoli projektu BeeWare přistupujte s respektem
Předpokládejte, že všichni mají dobré úmysly, i když si slova nevybrali nejlépe.
Předpokládejte, že pokud někdo něco udělal „špatně“, nepodařilo se nám správně vysvětlit postup.
Předpokládejte, že jakýkoli projev hněvu nebo frustrace vychází z upřímné touhy používat nástroj/knihovnu BeeWare.
Povzbuzujte ostatní členy komunity, aby tyto ideály zohledňovali ve své vlastní komunikaci, a to jak uvnitř komunity BeeWare, tak i mimo ni.
Žádný včelař by neměl commitovat vlastní kód
- Výjimka: „Něco je vážně rozbité a musí se to opravit hned.“
- Výjimka: BDFN (v budoucnu se to může změnit)
Veškerý kód, který člen hlavního týmu předloží ke kontrole, by měl zkontrolovat jiný člen týmu.
- Výjimka: BDFN (v budoucnu se to může změnit)
Veškerý kód by měl před sloučením projít testy kontinuální integrace.
- Výjimka: kód, o němž je známo, že nefunguje a který je z jiných důvodů nutné zapsat do repozitáře
- Výjimka: kód v repozitáři s nedostatečnými CI testy
- Výjimka: Funkční a commitnuté je lepší než dokonalé a necommitnuté
Přijímací procesy by měly být pokud možno automatizované
- To znamená testy, linting, kontrolu pravopisu, pokrytí a další.

Jak se stát včelařem¶

Přijetí nového včelaře do týmu je výhradně na rozhodnutí stávajícího hlavního týmu. Ačkoli pro to v současnosti neexistují pevná pravidla, člověk bude zpravidla pozván stát se včelařem projektu BeeWare, pokud prokáže významný přínos projektu. Může jít také o člověka se specifickou odborností (například iOS/macOS), která stávajícímu týmu chybí. Nemusí přitom jít pouze o commity. Každý, kdo prokáže trvalý zájem o projekt, může požádat o oprávnění zapisovat do jeho repozitáře.

Všichni noví včelaři budou „zasvěceni“ (pro nedostatek lepšího výrazu) do základních hodnot a pokynů projektu. Shrnutí základních hodnot naleznete na stránce O nás. Od každého, kdo se připojí k týmu, se očekává, že bude tyto hodnoty dodržovat a přispívat k diskusím o jejich vývoji v průběhu času.

Od žádného včelaře, nového ani zkušeného, se neočekává, že bude jediným správcem čehokoli. Existuje mnoho včelařů i mnoho dalších lidí, kteří mohou nabídnout pomoc, rady a mentoring.

„Commit bit“?¶

V unixových systémech označuje jediný bit v souboru oprávnění jej spustit. V systémech správy zdrojového kódu existuje obdobný bit označující možnost slučovat kód. Říci o někom, že má „commit bit“, znamená, že má právo zápisu do kódové základny. V prostředí GitHubu to znamená, že může slučovat pull requesty a zapisovat kód přímo do projektu.