Läsanvisning

Standarden beskriver ett antal kriterier. Alla kriterier har enhetliga avsnitt som tydliggör hur man skapar utmärkt offentlig kod.

Hänvisningar till “beslutsfattare”, “chefer” samt “utvecklare och formgivare” gäller alla som utför uppgifter förknippade med rollerna, oavsett deras tjänstetitel. Det är vanligt att enskilda personer har uppgifter som spänner över flera roller.

Nedan följer en kort förklaring av vart och ett av avsnitten och hur de används inom standardens kriterier.

Inledning

Avsnittet förklarar vad kriteriet syftar till att uppnå och varför det är viktigt för en kodbas’ användare och bidragsgivare.

Krav

Avsnittet listar vad som behöver göras för att uppfylla standarden.

Följande nyckelord i dokumentet ska tolkas enligt beskrivningen i IETF RFC 2119:

• MÅSTE (MUST)
• FÅR INTE (MUST NOT)
• KRÄVS (REQUIRED)
• SKALL (SHALL)
• SKALL INTE (SHALL NOT)
• BÖR (SHOULD)
• BÖR INTE (SHOULD NOT)
• REKOMMENDERAS (RECOMMENDED)
• FÅR (MAY)
• VALFRITT (OPTIONAL)

Hur du testar

Avsnittet erbjuder åtgärder du kan vidta för att se om ett bidrag uppfyller standarden. Det är avgörande om du vill tillämpa standarden i praktiken.

Vi har försökt formulera det så att även någon som inte är djupt insatt i ämnet kan göra en grundläggande kontroll av efterlevnaden.

Offentliga beslutsfattare: vad ni behöver göra

Avsnittet riktar sig särskilt till beslutsfattare genom att erbjuda dem konkreta åtgärder de kan vidta i sin roll.

Offentliga beslutsfattare sätter prioriteringar och mål för projekt och kan ha mindre teknisk erfarenhet.

Chefer: vad ni behöver göra

Avsnittet riktar sig särskilt till chefer genom att erbjuda konkreta åtgärder de kan vidta i sin roll.

Chefer ansvarar för att projekt levereras i tid, för intressenthantering och för fortsatt leverans av tjänsten. För detta är de helt beroende av såväl beslutsfattare som utvecklare och formgivare. De behöver skapa rätt kultur, samla rätt resurser och tillhandahålla rätt strukturer för att leverera utmärkta tjänster.

Utvecklare och formgivare: vad ni behöver göra

Avsnittet riktar sig särskilt till utvecklare och formgivare genom att erbjuda dem konkreta åtgärder de kan vidta i sin roll.

Utvecklare är vanligtvis mer tekniskt inriktade och har större inverkan på leveransen av tjänster än de tidigare grupperna.

Avgränsning

Standarden för offentlig kod är inte avsedd att täcka enskilda driftsättningar av en kodbas. Det innebär att standarden inte talar om för de som driftsätter hur de ska anpassa sig till sin organisations lokala tekniska infrastruktur eller rättsliga ramverk.

Även om standarden för offentlig kod hänvisar till flera standarder och har betydande överlappning med andra, är dess syfte att möjliggöra samarbete. Därför syftar den inte till att ersätta kvalitetsstandarder, som ISO 25000-serien, eller sådana som fokuserar på säkerhet, som OpenSSF Best Practices Badge, utan att samverka väl med dem.

Och även om syftet innefattar att möjliggöra samarbete, garanterar det inte att en gemenskap uppstår. Det kräver fortfarande initiativkraft och ambition utöver att göra kodbasen samarbetsklar.