Stanje pravil o prispevkih

Stanje

Odprto. Ta stran beleži, katera pravila za prispevke v tem fondu dokazljivo veljajo in katerih ni. Zamenjana bo, brž ko bodo odprte točke odločene.

Izhodišče

Področje Projekti vodi sodelujoče do oddaje spremembe. Od tam naprej nastopijo pravila, ki si jih projekt da sam: katera veja, kdo pregleda, kdaj se prevzame. Del teh pravil je v tem fondu zapisan in dokazljivo v veljavi, drug del ne. Brez tega razlikovanja nastane najdražja vrsta dokumentacije: taka, ki trdi pravilo, na katero se ni nihče zavezal, in se ga zato niti ne upošteva niti ne ovrže.

Kaj dokazljivo velja

Področje	Pravilo	Po čem je dokazljivo
Slog kodiranja	PSR-12, brez izjem od pravil	konfiguracija preverjanja delovnega prostora ter klica `composer cs` in `composer cbf`
Statična analiza	predvidena, stopnja 4	konfiguracija analize in klic `composer stan`
Besedilo objave	vsaka objava imenuje svojo delovno postavko v lastni sklepni vrstici	projektna pravila fonda; brez te vrstice ne nastane povezava med delovno postavko in kodo
Soavtorstvo	noben model se ne navaja kot soavtor objave	projektna pravila fonda
Prevzem na spremembo	preverjanje skladnje, zagonski tek, besedila vmesnika v petih jezikih, ponovna izgradnja svežnja CSS, primerjava dnevnika napak	projektna pravila fonda
Jezik	komentarji v izvorni kodi in dokumenti v repozitoriju angleški, wiki dokumentacija nemška, vmesniki v petih jezikih	projektna pravila fonda
Navedba avtorja	stalna navedba avtorja in naslova za lastno kodo	projektna pravila fonda
Signal izdaje	datum v manifestu paketa je signal, po katerem se posodobitev prepozna	projektna pravila fonda
Kdo odloča o sodelovanju	vzdrževalci zadevnega projekta, brez skrbniških pravic wikija	zaslon Mitglieder po projektu; preverba leži v `Domain/ProjectMembership` in jo držijo lastni testi
Meja te pristojnosti	vzdrževalec dodeli bralca in sodelavca, ne vzdrževalca	ista preverba; zavrne tudi ročno sestavljeno pošiljko
Klic testov	vsak paket s testnim imenikom ima lastno testno konfiguracijo in se kliče iz lastnega korena	dvanajst konfiguracijskih datotek, vse z enakimi stikali strogosti
Statična analiza v praksi	vseh 27 paketov zbirke, stopnja 4, fond zamrznjen	konfiguracija analize; tek se konča brez najdb le, če ni prišlo nič novega
Ime veje pri vračanju	na stopnji predlagati končna točka Git sprejme samo sklice pod `refs/heads/users/<uporabniško ime>/` in vse drugo zavrne, preden doseže izvorni sistem; na stopnji pisati zapora ne velja	preverba leži v `Domain/ReceivePackGuard` in jo držijo lastni testi. Nobena od štirih predlog priklopa ne podeli predlagati; stopnja nastane le iz posebej napisanega pravila

Česa ni

Področje	Ugotovitev
Model vejanja	Ni pravila. Ni določeno, na katero vejo sprememba sodi, kako naj se imenuje ali kdaj spet izgine. Tehnična zapora stopnje predlagati iz prve preglednice ni tako pravilo: omejuje, kaj končna točka sprejme, in ne pove ničesar o tem, kam sprememba vsebinsko sodi.
Postopek pregleda	Ni pravila. Ne pristojnost ne merilo uspešnosti nista določena.
Pravila združevanja	Ni pravila.
Označevanje različic	Ni sheme. Datum manifesta nosi signal izdaje, zaporedje različic s tem ni izrečeno.
Dnevnik sprememb	Ni konvencije. Med lastnimi paketi eden vodi dnevnik sprememb.
Pot prijave varnostnih lukenj	Nobene za lastne pakete.
Imenovanje vzdrževalcev	Ni pravila. Kdo postane vzdrževalec projekta, odloči wiki-skrbništvo; po katerem merilu, ni določeno.

Posledice

Kdor piše dokumentacijo za to področje, za drugo preglednico ne sme oblikovati pravila. Izmišljeno pravilo je tu dražje od manjkajočega: izgleda kot določitev, se kot taka navaja in nikogar ne zavezuje.

Navodila Oddaja spremembe zato opisujejo samo, kar platforma dejansko zmore, in imenujejo odprte točke, namesto da bi jih zapolnila.

Kdor odloči eno od odprtih točk, jo vnese v prvo preglednico, imenuje dokaz in prilagodi zadevna navodila.