wip

docs/administrative/fixtures.md

@@ -6,7 +6,7 @@ The NAIS team might look disorganised to a newcomer and in a certain sense of th
 
 ![Froom logo](../assets/froom.png)
 
-Thanks to COVID19 we have become "remote ~~first~~ only". And in case you are wondering; The froom is our zoom based digital workspace. Froom is a portmanteau of *Frode* and *Zoom*. Frode is a popular guy, so his personal Zoom space was where we all gravitated.
+Thanks to a pandemic, we have become "remote ~~first~~ only". And in case you are wondering; The froom is our zoom based digital workspace. Froom is a portmanteau of *Frode* and *Zoom*. Frode is a popular guy, so his personal Zoom space was where we all gravitated.
 
 We all hang out in the lobby and join breakout rooms for more in-depth exploration of topics that may not be of general interest.
 Anyone is welcome anywhere but "good manners" apply.

docs/administrative/nais-system/README.md

@@ -15,10 +15,10 @@ Oh, and we also have [holiday-modes](holiday-mode.md) in the summer and around C
 ## Why do we organize our work this way?
 
 - We value focus and deep work. We believe this leads to better solutions and happier team members. Having focus periods creates room for this. 
-- Basing our work on initiatives, forces us to be explicit and clear about our ideas. It makes it possible for everyone to keep up with what's happening and take part in the discussions. 
+- Basing our work on initiatives, forces us to be explicit and clear about our ideas. It makes it possible for everyone to keep up with what's happening and take part in the discussions. Bonus: a finished initative together with it's discussions serves as a ADR.
 - When working on a initiative, you don't have to start each day wondering what to do. Also, you know that what you do, makes sense. 
-- We belive that it creates a healthy commitment towards the rest of the team, that during the alotted time - you do your best work. 
-- Organizing our work this way, makes it possible to have a shared orientation in a large team
+- We belive that it creates a healthy commitment towards the rest of the team: namely that during the alotted time, you try to focus and do your best work. 
+- Organizing our work this way, makes it possible to have a shared orientation in a large team.
 
 
 

docs/administrative/nais-system/holiday-mode.md

@@ -1 +1,11 @@
 # Holiday modes
+
+During the summer and around Christmas, we have what we call _holiday modes_.
+These are week-long periods where we don't work in dedicated focus periods, but self-organize and let the work flow more organically. This is both because many people are on vacation, but also to break up the rythm a bit.
+
+Some suggestions for what to do during holiday modes:
+
+- Work on initiatives, or help out on the boards curated by the anchors. If you're unsure what to do, it can be a good idea to ask the anchor of the area you're interested in.
+- Work on stuff you've put off during focus periods.
+- Write a blog post.
+- Check with your team if there's something you can help out with.

docs/administrative/nais-system/initiatives.md

@@ -13,139 +13,37 @@ These are the key components of an initiative:
 ### Essence
 
 The essence should describe is the core idea and purpose of the initiative.
+This should be clear and concise, and ensures that you have solid understanding of the problem. 
 
-This should be clear and concise. This ensures that you have solid understanding of the problem, and help the working group make scoping decisions along the way.
-
-
-
-- especially important if you're not part of the working group
-- makes it easier to make scoping descisions along the way
-
-1. Finn essensen
-
-> Hva er problemet, og hvorfor er det viktig å løse?
-
-Man har ofte bare en løs idé eller en magefølelse på at noe bør gjøres.
-Det kan da ofte være lurt å ta noen runder med seg selv, men aller helst sparre med en venn for å finne ut hva som er essensen.
-
-Noen ganger er det åpenbart hva problemet er og hvordan det kan løses, mens noen problemstillinger krever mer forskning for å bli tydelige. Initiativet kan da ofte ta uventede veier. Noen ganger finner man kanskje andre viktige aspekter eller avhengigheter. Dette kan enten utvide den opprinnelige idéen eller ende opp som selvstendige initiativer. Noen ganger kan man ende opp med å forkaste hele greia.
-
+In addition this helps the working group make scoping decisions along the way.
 
 ### Investment
 
-2. Finne investeringsviljen
-
-> Hvor mye er vi villig til å investere i den grunnleggende idéen?
-
-Investeringsviljen er hvor mye tid vi er villige til å investere, og dermed hvor mye vi skal gjøre. Den låser tiden, slik at den er fast, mens scope er variabel. Gitt uendelig tid kan vi løse hva som helst, mens med begrenset tid må teamet ta beslutninger om hva de har tid og ikke har tid til å gjøre. 
-
-For et idé kan man se for seg tre ulike investeringsviljer:
-1. Hvis vi bare hadde én uke, kunne vi hacket det til på den måten her...
-2. Hvis vi hadde 6 uker, kunne vi gjøre det, dette og den andre tingen...
-3. Hvis vi hadde 6 måneder, kunne vi skrevet om denne tjenesten og reimplementere det slik...
+All iniatives are timeboxed to a certain number of weeks or days. This is the upper limit of how much time we are willing to spend on it, before we do a re-evaluation.
 
-Poenget med å finne investeringsviljen, er at vi holder fokus på det som betyr noe™. _Eksempel:_ 2 personer i 2 uker 
+It's important to note that this is not an estimate of how long it will take to complete the initiative, but rather a statement of how much time we feel is reasonable to spend on it given the potential impact.
 
 ### Non-goals
-as well as the non-essentials. This is especially important if you yourself isn't part of the working group.
+
+During the shaping process, you often identify rabbit holes and critial paths that you don't want to go down. These should be listed as non-goals with an explanation.
 
 ### Possible solution
 
-Make sure that there actually exists a path to success by sketching out how one envisions a _possible_ solution. Important to note that the working group is free to deviate from this as long as the essence is preserved.
+Make sure that there actually exists a path to success by sketching out how one envisions an actual _possible_ solution. 
 
 This exercise ensures that what is proposed is technically feasible. By going through the moving parts involved, you're usually able to detect any obvious show stoppers as well as possible rabbit holes to avoid. These should be listed as [non-goals](#non-goals).
 
-Having worked through this, we can also see if we are introducing or removing any components, creating any new dependencies or taking on any new responsibilities. 
-
-Being able to understand the technical and/or human impact is crucial when evaluating the initiative.
-
-Depending on how clear your understanding of the problem is, this can be a chaotic process where many ideas are thrown around and you find yourself exploring many alternative solutions, refining the essence, and the investment as you go along.
-
-To make sure you understand the different 
-
-Her kan det være lurt å involvere de som har kjennskap/eierskap fra før for å få med historikken og deres perspektiver.
-Man kan eventuelt bruke nais-tech, github issue eller noe liknende.
+Having worked through this, we can see if we are introducing or removing any components, creating any new dependencies or taking on any new responsibilities. 
+Understand the technical and/or human impact is important aspects when evaluating the initiative.
 
-Ved å få flere alternativer på bordet og faktisk utforske hva man trenger å gjøre for å komme i mål, klarer man forme et tydelig bilde som forteller hvilken retning man bør gå.
-Man klarer også å sette ord på hvorfor man valgte den ene retningen over de andre, slik at de som skal utføre initiativet ikke trenger bruke tid på å utforske idéer som allerede har blitt undersøkt.
-Noen ganger finner man kanskje en løsning som løser 90% av problemet med 20% av innsatsen, og da er det ofte å foretrekke; ikke la det perfekte stå i veien for det som er `Godt Nok™ `
+If the solution impacts or involves some parts of Nais, make sure that the relevant people (e.g. anchors) are involved in the shaping process.
 
-Andre ganger finner man en vei som løser 150% av problemet som gir mer mening enn den opprinnelige idéen.
-I disse tilfellene kan det være greit å revurdere investeringsviljen og kanskje også essensen av oppgaven man satte i begynnelsen.
+Rough sketches can also be helpful to help the working group understand the rough idea you have in mind.
 
-Når man skal skissere løsningen i grove trekk er det viktig å bruke tykk tusj.
-Med det menes at man ønsker å tegne et bilde som forklarer hva som skal gjøres, men utelate detaljer som fjerner handlingsrommet til de som skal utføre.
-Eksempel: tegninger av omtrentlig hvor en knapp kan plasseres i en frontend og hva som skjer når du trykker på den, men ikke hvordan knappen ser ut eller designdetaljer i en graf.
-
-Det viktigste her er å ende opp med en mental prototype av en farbar vei fra A til Å. Hvor man har tenkt konkret igjennom hvordan dette kan henge sammen.
+Depending on how clear your understanding of the problem is, this can be a chaotic process where many ideas are thrown around and you find yourself exploring many alternative solutions, refining the essence, and the investment as you go along.
+Note that the working group is free to deviate from this as long as the essence is preserved.
 
 
 ### Other relevant information
 
-
-Why's:
-- Forces us to think deeply about why we're doing things
-- Forces us to think deeply about the task at large, to understand if it's technically feasible to do and what is the 
-- Forces us to think about and highlight what the technical long term cost of whatever is introduced is (or deducted)
-- Makes it possible for everyone to take part in the discussions and keep up with what's happening
-- Automatically documents and tracks meaningful work and corresponding discussions
-- It's presented in a relatively standard format, so it's possible for someone other than yourself to do the work. 
-
-
-idea --shaping-> initiative
-
-
-To 
-
-Et ferdig formet initiativ, tar en idé man har og plasserer den i **kontekst av NAIS** og presenteres på et format som gjør det mulig for andre enn deg selv å gjennomføre det.
-Det fremgår tydelig **hvorfor** vi bør gjøre dette, og hvilken effekt dette vil ha for hvem.
-
-Med dette som utgangspunkt, sier man hvor lang tid vi vil investere i dette initiativet.
-Dette angis i antall uker for et team på to personer. Dette er ikke et estimat på hvor lang tid man tror det tar.
-
-Gitt investeringsviljen, lager man en grov skisse av hvordan man ser for seg én mulig løsning (ikke Løsningen™).
-Om sluttbrukere påvirkes, bør det fremgå tydelig hvordan.
-Man beskriver hvordan initiativet treffer de tekniske komponentene som involveres, og om det må lages noe nytt. Da blir det lettere å vurdere den tekniske konsekvensen/bærekraften.
-Man setter i dette arbeidet rammene for **hva som er essensielt** at blir løst og hva som er **ikke-mål**. At noe er definert som et ikke-mål, betyr at det er definert som mindre vesentlig for dette spesifikke initiativet - ikke at det er uviktig eller aldri skal gjøres. Ikke-mål følges ofte av en begrunnelse.
-
-#### Et ferdig formet initiativ skal inneholde følgende:
-
-- Overskrift
-- Investeringsvilje
-- Essensen
-- ikke-mål
-- Mulig løsning i grove trekk
-- Eventuell annen relevant informasjon
-
-# Hvordan forme et initiativ
-
-Å forme et initiativ er en kreativ og kaotisk prosess, så det er ingen fasit på hvilke steg som må gjennomføres eller hvordan.
-Alle står fritt til å forme sine egne metoder for å komme i mål, men vi har hatt nytte av å tenke på det i følgende rekkefølge:
-
-
-### 4. Ikke-mål
-
-> definere ikke-mål og adressere potensielle kaninhull
-
-Vel så viktig som å identifisere hva man skal gjøre, er å tydeliggjøre hva man ikke skal gjøre.
-
-Mens man kartla terrenget i forrige steg, utforsket man antakelig mange alternative løsninger. Disse kan man nå definere som ikke-mål med en begrunnelse.
-I tillegg har man også identifisert temaer hvor man ser kan grave seg ned i det uendelige. Skriv dem opp og forklar hvor man skal stoppe og hvorfor.
-
-### 5. Renskrive initiativet
-
-> tl;dr av problemet som gir leseren forståelse av hva som skal gjøres og hvorfor
-
-På dette tidspunktet har man antakeligvis all informasjonen man trenger for å presentere initiativet til hele teamet. Dette gjør man ved å opprette et issue i RFC-kolonnen i nais-system-boardet.
-Issuet følger [denne malen](#et-ferdig-formet-initiativ-skal-inneholde-følgende)
-
-### 6. RFC
-
-> Request For Comments
-
-Frem til nå har det vært en ganske kaotisk prosess, hvor mange idéer og potensielle løsninger har blitt kastet frem og tilbake og nøkkelpersonell har vært involvert.
-Idéen er nå moden nok til å involvere resten av teamet, slik at de kan komme med sine perspektiver og innsikt uten å måtte forholde seg til rå-idéen
-Dette steget er like mye for at teamet som helhet skal vite hva det er som er i gjære som for at alle skal få kommentert på foreslått løsning.
-
-Det er forhåpentligvis få og små justeringer som må til før initiativet kan påbegynnes etter en RFC-prosess.
-
+List any other relevant information that might be useful for the working group to know. Links, images, sketches, etc.