Stanje pravila o doprinosima

Status

Otvoreno. Ova stranica bilježi, koja pravila za doprinose u ovom fondu dokazivo vrijede i koja ne postoje. Bit će zamijenjena, čim se otvorene točke odluče.

Polazno stanje

Područje Projekti vodi suradnike do predaje promjene. Od ondje nastupaju pravila, koja si projekt zadaje: koja grana, tko pregledava, kada se preuzima. Dio je tih pravila u ovom fondu zapisan i dokazivo na snazi, drugi dio nije. Bez te razlike nastaje najskuplja vrsta dokumentacije: ona, koja tvrdi pravilo, na koje se nitko nije obvezao, i koje se zato niti slijedi niti pobija.

Što dokazivo vrijedi

Područje	Pravilo	Po čemu je dokazivo
Stil kodiranja	PSR-12, bez iznimaka od pravila	konfiguracija provjere radnog prostora te pozivi `composer cs` i `composer cbf`
Statička analiza	predviđena, razina 4	konfiguracija analize i poziv `composer stan`
Tekst objave	svaka objava imenuje svoju radnu stavku u vlastitom zaključnom retku	projektna pravila fonda; bez tog retka ne nastaje veza između radne stavke i kode
Suautorstvo	nijedan se model ne navodi kao suautor objave	projektna pravila fonda
Primopredaja po promjeni	provjera skladnje, zagonski prolaz, tekstovi sučelja na pet jezika, ponovna izgradnja snopa CSS, usporedba dnevnika pogrešaka	projektna pravila fonda
Jezik	komentari u izvornoj kodi i dokumenti u repozitoriju engleski, wiki dokumentacija njemačka, sučelja na pet jezika	projektna pravila fonda
Navod autora	stalan navod autora i adrese za vlastitu kodu	projektna pravila fonda
Signal izdanja	datum u manifestu paketa signal je, po kojem se ažuriranje prepoznaje	projektna pravila fonda
Tko odlučuje o sudjelovanju	održavatelji dotičnog projekta, bez skrbničkih prava wikija	zaslon Mitglieder po projektu; provjera leži u `Domain/ProjectMembership` i drže je vlastiti testovi
Granica te nadležnosti	održavatelj dodjeljuje čitatelja i suradnika, a ne održavatelja	ista provjera; ona odbija i ručno sastavljenu pošiljku
Poziv testova	svaki paket s testnim direktorijem ima vlastitu testnu konfiguraciju i poziva se iz svojeg korijena	dvanaest konfiguracijskih datoteka, sve s istim stupnjem strogosti
Statička analiza u praksi	svih 27 paketa paketne zbirke, razina 4, fond zamrznut	konfiguracija analize; prolaz završava bez nalaza samo, ako ništa novo nije pridošlo
Naziv grane pri vraćanju	na razini predlagati Git krajnja točka prihvaća samo reference pod `refs/heads/users/<korisničko ime>/` i sve drugo odbija, prije nego što dosegne izvorni sustav; na razini pisati pregrada ne vrijedi	provjera leži u `Domain/ReceivePackGuard` i drže je vlastiti testovi. Nijedan od četiriju predložaka priključivanja ne dodjeljuje predlagati; razina nastaje samo iz posebno napisanog pravila

Što ne postoji

Područje	Nalaz
Model grananja	Nema pravila. Nije utvrđeno, na koju granu promjena pripada, kako se treba zvati ili kada opet nestaje. Tehnička pregrada razine predlagati iz prve tablice nije takvo pravilo: ona omeđuje, što krajnja točka prihvaća, i ne govori ništa o tome, kamo promjena sadržajno pripada.
Postupak pregleda	Nema pravila. Ni nadležnost ni mjerilo prolaza nisu utvrđeni.
Pravila spajanja	Nema pravila.
Verzioniranje	Nema sheme. Datum manifesta nosi signal izdanja, redoslijed inačica time nije iskazan.
Dnevnik promjena	Nema konvencije. Od vlastitih paketa jedan vodi dnevnik promjena.
Put prijave sigurnosnih propusta	Nijedan za vlastite pakete.
Imenovanje održavatelja	Nema pravila. Tko postaje održavatelj projekta, odlučuje wiki-administracija; po kojem mjerilu, nije utvrđeno.

Posljedice

Tko piše dokumentaciju za ovo područje, za drugu tablicu ne smije oblikovati pravilo. Izmišljeno je pravilo ovdje skuplje od nedostajućeg: izgleda kao utvrđenje, navodi se kao takvo i ne obvezuje nikoga.

Upute Predaja promjene zato opisuju samo, što platforma doista pruža, i imenuju otvorene točke, umjesto da ih popunjavaju.

Tko odluči jednu od otvorenih točaka, unosi je u prvu tablicu, imenuje dokaz i prilagođava pogođene upute.