208. Dokumentation… hemskt tråkigt eller en next level superkraft?🪶

[00:00:00] Sofia: Och jag dokumenterar ju inte med min familj om vi har kommit överens om... Fast man borde göra det ibland, känner jag. Jo kontrakt behövs fan ibland. Men det är inte så här att vi bara, okej vi ska ha nya levnadsvanor i år. Låt oss skriva ett designdokument om det. Man kanske borde.

Du lyssnar på Developers, podden där du får följa med oss, Sofia och Madde, på allt inom mjukvaruutveckling. Vi

[00:00:39] Madde: träffar spännande gäster, testar nya teknologier, söker inspiration och tar upp aktuella ämnen Vi har ju snackat innan om att Apple Intelligence inte har funnits tillgängligt i EU.

[00:00:54] Sofia: Eller vissa funktioner ja de börjat

[00:00:58] Madde: släppa på lite nu jag fick nyligen tillgång på min dator dock inte på telefonen för där står det fortfarande att min region inte stöds trots att jag har den på US English vilket jag alltid har haft så jag vet inte riktigt men min dator i alla fall, där lyckades jag få till Apple Intelligence så nu har jag ju fått tillgång till den här vad heter det Image Playground ja Jag har inte

[00:01:24] Sofia: testat det, för i min mobilstad är det inga intelligence features, men du sa att det fanns på datorn.

[00:01:30] Madde: Ja, det är på datorn, jag provat det. Det fanns inte på telefonen för mig, men det ska finnas också, jag vet inte exakt.

[00:01:35] Sofia: Är det någon app man måste ladda ner?

[00:01:38] Madde: Eller

[00:01:38] Sofia: fanns det med typ senaste uppdateringen? Den kom med senaste

[00:01:40] Madde: uppdateringen, så är det bara att starta i Spotlight.

[00:01:43] Sofia: Okej för jag söker nu, vad sa du, den heter Image Playground.

Ja, men det har jag inte uppdaterat. Nej, det kan vara det. Bra

[00:01:51] Madde: tips. Det är ju typ, ja, man kanske hörde om namnet Image Playground, men det är ju för att kunna skapa AI-genererade bilder. Och för alla som är i Apple-ekosystemet liksom, så... Allting hänger ihop på ett så himla snyggt sätt tycker jag. Det är speciellt nice.

Så nu har jag ju alla mina foton på alla mina kompisar. Och då har ju Apple typ grupperat Android och Google Photos och allt sånt Det gör säkert exakt samma sak. Så det är inte så att jag tycker att Apple heter det. Jag bara försöker förklara hur det hänger ihop nu. Så jag har ju fått alla mina personer så här.

Så har jag Sofia, Madeleine, Oskar, bla bla bla. Och då kan jag ju välja vem jag vill AI-generera. Så jag har ju AI-genererat både dig och mig till exempel Ja,

[00:02:36] Sofia: just det. Det blev ju så... Alltså det var väldigt så här goofy typ tecknat. Men man såg verkligen att det var... Du och jag. Och det var ändå imponerande.

Eller samtidigt inte. Jag har ju sett... Vi har ju testat någon... Jag kommer inte ihåg vilken modell det var. Men vi har ju testat... När min mamma har genererat bilder oss Ja som typ krigarprinsessor och allt vad hon gjorde. Och de blir ju helt verklighetstrogna. Om man betalar för det. Men de här var ändå bra.

Men... För jag hörde ju när Apple Intelligence släpptes att man ska skapa sina avatarer med hjälp av det. Är det det som är poängen med det här? Är det bara för att skapa porträtt eller kan jag skapa vad jag vill?

[00:03:25] Madde: Den kan skapa vad man vill också. Så du kan ju ta vilken bild som helst i ditt fotobibliotek Jag testade till exempel att lägga upp bild på alla mina bananer Det blir jäkla tjat om mina bananer Så då genererar den ju liksom jättemånga bananer till exempel.

Och sen kan man även prompta. Så att jag promptar ju på bilderna på dig och mig. Då promptar jag ju att vi skulle ha podcastmikrofon och På dig skulle du ha beige hörlyrar, jag skulle ha svarta och sånt. Och sen så finns det lite färdiga också, som i grund och botten antar jag är någon prompt. Men för dig ser det bara ut som att du klickar på att du ska renderas som en mage.

Eller du ska renderas som en partyhunt eller i en solnedgång

[00:04:08] Sofia: Men för det första alla som har någon nyare, jag tror att det är på alla nyare Android-telefoner, jag vet inte men typ såhär Samsung och Googles vad heter den? Ingen av dem. Pixel. Alltså de som har AI, Gemini de har ju kunnat göra det här ett tag så att, jaja, vi vet.

Jag tyckte bara det var roligt. Ja men Men det viktigaste, jag har ju klagat på att varje gång jag har försökt generera dig och mig med typ såhär chat-gbt i de här mer, alltså de här specifika generatorerna så har de gjort oss väldigt slampiga. Nej just det. Hur mycket jag har försökt, så bara nej men snälla, gör en mer realistisk kvinna.

Också såhär otroligt smala, inte ens såhär att det är kvinnor med... Liksom ens normala jag vet inte kurvor anses väl sexigt men det är ändå såhär jättesmala typ modellkvinnor jätteoverkliga hur var det

[00:05:18] Madde: här? här var ju bara typ porträtt så att man såg ju inte direkt kroppen men jag fick ju inte heller riktigt känslan av att de skulle vara Sexiga på det sättet eftersom de var väldigt cartoonish.

Jag fick skriva typ såhär, det var någonting jag skrev som blev helt konstigt. Om det var typ att jag skulle ha bryna ögon eller någonting, så bara gjorde de hela, så den såg väldigt annorlunda ut så att det var lite skumt. Det tycker jag är väldigt Vad ska man säga, nästan lite jobbigt med sådana här AI-genererade bilder på mig själv av liksom, när de kollar på bilder är ju att det är ju lite som när man går till någon sån här karikatyrmålare, du vet som finns när man är utomlands, för den lyckas ju framhäva saker som är lite speciella, alltså såhär på mig till exempel Nu kommer jag ju outa det här så att alla kanske kommer tänka på det nu.

Men typ mitt ena öga är lite större än det andra.

[00:06:19] Sofia: Vilket aldrig aldrig

[00:06:21] Madde: tänkt på. Nej det är ingenting man går runt och tänker på. Men jag typ som man självkritisk och har tagit... Gud vad bästamma. Man har tagit en selfie. Men så här i AI-bild. Så bara... Typ såhär, syns skithyligt det var samma sak på tal

[00:06:38] Sofia: om ens fula features när jag visade min festmant om bilderna som du hade genererat så jag bara, titta vad likt han bara, ja han nämner inte såhär ja, dina fina söta ögon kommer fram eller någonting sånt utan han säger, ja Den fick ju verkligen med din typ såhär runda näsa och dina de här mormors, han sa typ såhär mormors vad är det jag försöker säga?

Nasobialväck heter det. Det har jag inte hört, men okej Ja typ skrattväcker. Ja, ja ja. Tack! Tack älskade du att du påpekade två saker i mitt ansikte som jag inte gillar, resten tycker jag om.

[00:07:28] Madde: På mig så framhävde den också väldigt stora framtänder och sånt tyckte jag, vilket jag gör, har ju absolut stora framtänder.

[00:07:36] Sofia: Men det här är ändå bra för det är precis såhär, du vet när man använder filter, Snapchat, Instagramfilter, Jag har ju tagit verkligen en före-efter ibland, där jag är så still jag bara kan för att se, vad är det den gör? Vad är det i mitt ansikte som jag saknar för att bli så här vacker? Då ser jag hur den verkligen gör min näsa mindre

[00:07:58] Madde: och

[00:07:59] Sofia: suddar ut de här linjerna.

Alltså det är precis det den tar bort. Och sen ser man det och sen går man och tänker, kanske ska jag göra nasobialväcksfillers studiefolkar och näsoperation.

[00:08:15] Madde: Nu blev det väldigt deprimerande här. Jag bara plockade fram våra svagheter liksom.

[00:08:20] Sofia: Det är viktigt. Teknik är inte bara kul. Det har jag också.

Jag tänkte prata om TikTok och uppdatera det. Men den här historien är inte över. Jag tänker inte ens försöka. Jag tycker bara att det amerikanska systemet är bara... Helt sinnessjukt. Jag vill inte ens prata om det. Och allt med mask på den här armen som folkens debatterar ifall det var en hejlning eller inte.

Ja. Jag bara, jag orkar inte. De försöker inte stödja dig längre. Nej,

[00:08:59] Madde: jag har sett många som har skrivit typ såhär testar du att göra det här på din arbetsplats och se hur folk reagerar. Ja, och sen bara nej

[00:09:06] Sofia: det var bara en

[00:09:08] Madde: hälsning.

[00:09:09] Sofia: Alltså nej ja. Man hade ju fått sparken.

[00:09:14] Madde: Ja nej jag orkar inte alls. Alltså som sagt, jag har ju länge tyckt att han är lite små obehaglig och läskig men det här är alltså...

Det börjar ju verkligen eskalera. Nu kommer vi säkert tappa lyssnare för det här men det skiter jag i att jag står framför vad jag tycker.

[00:09:27] Sofia: Fast jag tror, alltså om det finns en procent som lyssnar som tycker att man ska hajla och tycker att det Hitler gjorde var toppen, då vill jag inte ha dem som lyssnar ändå Nej Sen kan man ha åsikter om jag vet inte vad det där ska in i vad är det vi syftar på när vi tappar folk åsikter om invandringspolitiken jag tror att det är något helt annat och jag tror att de flesta som ens har dem mer åt höger inte är Ja, nazister vill i alla fall inte klassas i som det, jag vet inte.

Nej, men vi skiter i det för det är bara så deprimerande. Och faktiskt, jag börjar bli rädd på riktigt för vad de här människorna kan göra. Ja, när man sitter med så mycket

[00:10:15] Madde: pengar och

[00:10:15] Sofia: allting. Nej, det är mörkt Men en roligare liten tech-sak... Det har släppts typ förra eller förra veckan så släpptes det lite rykten om att det ska komma en iPhone, och vänta på modellnamnet, en iPhone Air.

Va? Ja Och liksom det enda den verkar ha är att den är tunnare.

[00:10:48] Madde: Okej men jag tänker om man tänker MacBook Air så är ju den väldigt, alltså den har ju lite sämre prestanda än en MacBook Pro till exempel.

[00:10:56] Sofia: Ja, för den kan ju inte kyla och bla bla bla. Ja, men

[00:10:59] Madde: lite sånt. Kan det vara något liknande här då, eller är det bara att den är tunnare?

[00:11:04] Sofia: Nej man vet ingenting, det var bara, det är ett rykte, jag vet inte, släppts kanske någon bild och så, eller någon har läckt det. Ja. Men jag håller verkligen med techreportrarna som har analyserat det här. Är att såhär, på riktigt. Du har ju en helt ny iPhone. Alltså att den skulle vara tunnare. Lägger det ens på din såhär top 5, top 10 på saker du har funderat på och önskar från din telefon?

[00:11:33] Madde: Nej alltså grejen är ju att om den är tunnare så kommer den ju vara obehaglig att hålla i på något sätt. Alltså om den är för tunn så blir det ju... Inte så greppvänligt tänker jag.

[00:11:41] Sofia: Ja, minsta iPhone typ sex och sju de var jättetunna. Var det de som också hade ganska vassa kanter typ? Nej nej Första generationen var lite mer som de är nu, alltså mer vassa.

Och sen kom de här supertunna de var alltså, ja. Nej, de är inte så sköna att hålla i. Nej Nej, det var bara såhär, och de bara, men det enda du gör är att du ändå går och smäller på ett skal. Alltså det är det brödrottsskalet som vi pratade om för några avsnitt sedan. Ja, och det är såhär, man kunde inte ha gjort någonting bättre.

Alltså jag hade hellre tagit att den var tjockare, men hade mycket mer batteritid. Det är ju sviviktigt för vissa människor. Ja. Nej, jag antar att det är såhär, just det, det som kom sen, det var då att Samsung hade typ något launch-event, jag tror att det är ett pre-launch-event för man fick inte riktigt känna på telefonerna, de visade upp en supertunn telefon.

[00:12:45] Madde: Allting går i trender känns det som. Plötsligt kom det ju med att man skulle kunna ha så här vikbara telefoner och sen så försvinner det och liksom.

[00:12:53] Sofia: Nej men det är väl hett. Det är väl dit vi förhoppningsvis väger. Alltså om Iphone hade släppt det vikbar, ja. Alltså där har vi ju någonting. Nu snackar vi.

Samsung Är det Samsung som har gjort dem? De har ju börjat bli stora. Galaxy

[00:13:07] Madde: Fold är det väl den heter?

[00:13:08] Sofia: Ja, och Pixel har också en foldable. Nej, jag vet inte. De har inget nytt att komma med så att tunnare är det enda vi kan göra. Och jag antar att de kan göra dem tunnare är ju för att vi har ju börjat få de här foldtelefonerna.

Och då betyder det att det är möjligt att göra mycket tunnare telefoner nu. Så vad Vad ska du annars ge folk på hårdvarusidan än tunnare fast ja de kunde smälta på mer batteri men det är väl, jag vet inte det vore sjukt ditt iPhones presentation varje år är såhär, hur mycket typ större skärm Det har blivit och hur mycket mindre någonting väger och hur mycket tunnare det har blivit varje år.

Man

[00:13:55] Madde: vill inte ha hur stor telefon som helst heller. Kan du gå runt med en iPad i fickan? Det blir bara konstigt. Jag ska ändå vara bekväm. Jag tycker de som är Pro Max är för stora. För mina små nätta händer. Jag har funderat på att skaffa

[00:14:12] Sofia: en större. Ja

[00:14:13] Madde: Är det så? Vad

[00:14:14] Sofia: lockas? Nej men jag håller med. Det är jättesvårt att hålla den.

För att iPhone 16 och de är ju redan väldigt stora. Samma med Samsung Pixel. De är skitstora redan. Men jag är ändå så här. Mina föräldrar har de stora. Och det är rätt så nice när du ändå ska scrolla eller när du faktiskt ska göra någonting. zooma in och

[00:14:38] Madde: se större text.

[00:14:40] Sofia: Ja, men de jobbar på sina telefoner väldigt mycket.

Och då köper jag det. Men tänk dig varje gång du faktiskt ska göra någonting och sitta still. Då är det ju mycket bekvämare med en stor telefon. Men inte när du är på språng. Inte när du promenerar. Du får inte ner den i någon ficka Speciellt för tjejer. Vi har typ inga fickor Vi har ju inte ens fickor.

[00:15:00] Madde: Nej.

[00:15:02] Sofia: Det var den nyheten

[00:15:05] Madde: ja vi får se om de släpper något mer men jag antar att de kommer i september i så fall som alla andra telefoner

[00:15:11] Sofia: ja

[00:15:11] Madde: men det är inte

[00:15:12] Sofia: bekräftat att det är ett rykte att det ska komma något air och jag antar att Samsung blev såhär oh my god vi måste också visa upp en tunderefon

[00:15:22] Madde: får det komma om ett halvår så får ni se vad ni hörde först

[00:15:25] Sofia: ja låt oss tacka våra patrons Tack till våra skönsrapportrar Alicia, Anders Nylund, Björn Jonsson, Dag Rönnell, Filip Åhlander, Kajetan Kazimierczak, Nyström, Molly Haglund, Oskari, Per Nåtby, Selim Hjorthall och Tomas Nilsson.

[00:15:45] Madde: Varför sa du bara Nyström och inte Lars Nyström?

[00:15:49] Sofia: Jaha, ett fönster på ivägen. Jag tänkte såhär, jaha han har väl bytt. Jag ser en liten flik av ett fönster på ivägen. Förlåt Lars, Lars var ju typ dessutom jag tror Patreon nummer ett. Ja. Ja, tack till er stjärnsupporters och tack till alla andra som stöttar oss på Patreon.

[00:16:18] Madde: Ja, det betyder jättemycket för oss.

Och vi har fått lite medländande det är faktiskt på Instagram, inte via vårt frågeformlar. Men det är två pers nu som har bett om att vi ska göra avsnitt om dokumentation. Och den är så svår tycker jag. Alltså

[00:16:40] Sofia: det låter ju inte roligt, eller hur, när man säger det.

[00:16:43] Madde: Nej men dokumentation känns som att det är en sån grej som man typ ska tycka illa om.

Alltså att det är coolt att säga att det är så tråkigt att dokumentera sin kod.

[00:16:54] Sofia: Men

[00:16:54] Madde: det är,

[00:16:55] Sofia: ja, det känns för det går tillbaka till att skriva rapporter i skolan, alltså... Det fanns väl några nördrar som tyckte det var toppen. Eller typ så här, tittar man på en polisserie så är det det värsta de vet. Det här, nu behöver jag skriva ihop en rapport på tolv sidor.

[00:17:14] Madde: Ja, sant. Ja, men det är klart det är roligare att bara få leverera någon form av värde. Men dokumentation är också värde i och för sig. Men det var ju för några, jag kommer inte ihåg när vi pratade om detta- Vi pratade om dokumentation i något sammanhang i något avsnitt. Och då sa vi att man kanske skulle bli den som blir riktigt pro på att dokumentera.

Och du sa ju senast innan vi spelade in nu, att du var väldigt duktig på det. Eller så?

Jag

[00:17:45] Sofia: hoppas inte folk i mitt team lyssnar. Jo, men det skulle jag ändå säga att jag är. För att jag är väl den som har... Kanske skrivit mest på vår konferens just nu, då är jag väl ändå jämfört med dem i mitt team. Okej.

[00:18:05] Madde: Jag kom på tredje plats. Ja, men vi var bara tre.

[00:18:11] Sofia: Av tre, ja exakt. Det är så många vi är just nu faktiskt.

Det blir några fler nästa vecka.

[00:18:18] Madde: Jag tänkte, ska vi läsa det här eller är det intressant att höra själva lyssnarfrågorna i sig eller Ja men det

[00:18:27] Sofia: tror jag, för jag tror att väldigt många som lyssnar, typ såhär är du ny? Så vad då, vad menar du med dokumentation? Och sen att det finns olika typer av dokumentation, alltså vad är det vi pratar om?

Jag tror det är ändå intressant varför har folk skrivit till oss och vad är det de undrar och

[00:18:48] Madde: så får ni veta att vi inte bara hittar på nu för att vi ska ha något att prata om vi bara vill lova vi fick en lyssnafråga nej först så lät det såhär Kan ni prata om dokumentation? Det hade varit trevligt om ni kunde dela med er om era erfarenheter och om ni har hittat någon bra struktur att skriva dokumentation på.

Det känns som att många utvecklare försöker undvika detta men det är väldigt hjälpsamt om man är ny i projektet eller testare. Eller ja, för alla. Vi har en wiki som är sjukt rörig och jag vill styra upp den så jag är tacksam för tips eller en podd.

[00:19:19] Sofia: Ja, ska jag lyssna eller ska jag läsa den andra eller?

Ja men det kan du göra.

[00:19:24] Madde: Jag

[00:19:25] Sofia: lyssnar på avsnitt 197 som börjar med frågan om att helst ha en kollega som överkomplicerar men för bra dokumentation Eller att ha en kollega som skriver effektivt kod men inte dokumenterar. Okej så vi hade någon would you rather där. Och det fick mig att inse att jag vet inte ens vad det innebär att dokumentera sin kod.

Jag läser andra året på IH-utbildningsutvecklare och ska ha praktik om två veckor. Vi har inte lärt oss att dokumentera, så ni får jättegärna ha ett avsnitt där ni pratar om det. Vad innebär det att dokumentera Hur noggrant förklarar man sin kodig dokumentation? Dokumenterar ni egna hobbyprojekt eller är det mest till för när man jobbar i team?

Eller finner ni det användbart även när ni kommer tillbaka långt senare och ska förstå vad ni själva har gjort? Jag tycker att jag svarar lite på din egna fråga här.

[00:20:17] Madde: Ja, men så är det ju. Och jag ska säga att jag har heller aldrig direkt lärt mig att dokumentera. Alltså även vi som läste på universitetet har inte fått någon kurs i dokumentation.

Om det inte var anledande på när du läste, men... Nej, det var inget

[00:20:34] Sofia: kursmoment på det sättet.

[00:20:37] Madde: Och... Jag kan inte såhär direkt komma på någon bok på ämnet. Alltså det är inte så att det finns boken om dokumentation Precis som man tänker typ Clean Code-boken finns ju. Alltså där är ju vissa böcker som är kända branschen så att säga.

Jag är helt säker

[00:20:54] Sofia: på att någon kommer länka till den och bara.

[00:20:56] Madde: Gör gärna det. inte känna till detta? The art of documentation. Men vi snackar lite som sagt från våra erfarenheter och så. Om man börjar då med varför är det viktigt att dokumentera. Dels så nämnde ju en av personerna själva att det är ju väldigt mycket enklare när man kommer in som ny person i ett projekt.

När det finns någon form av dokumentation. Det vet man ju själv när man har börjat. Det värsta som finns tycker jag är när det inte ens finns en typ. En superenkel readme där det står hur sitter du uppe i projektet. Det känns verkligen som... Bare minimum och bara så här skriv vad du gör för att starta det.

Vilka behöver du installera något särskilt och liksom var hittar du en NV-fil eller liknande eller alla secrets eller vad det kan vara.

[00:21:48] Sofia: Ja, absolut. Jag håller med. Onboarding. Det är snällt mot den som börjar men sen är det också typ en kostnadsfråga för företaget Du borde ha det för att personen inte ska spendera för mycket tid att bara göra ingenting.

[00:22:01] Madde: Ja. Ja, verkligen. Så det skulle jag säga är kanske en av de största faktorerna. Sen är det klart att det är också enklare ibland om man har jobbat länge i projektet och inte riktigt kommer ihåg allting man har gjort tidigare. Och så dyker det upp någon bugg eller någonting och så ska man gå tillbaka och tänka, shit, varför har vi gjort så här?

[00:22:24] Sofia: Ja men då går vi in på att det finns så många olika typer av dokumentation man kan göra, eller hur?

[00:22:29] Madde: Ja ja, ja. Det är ju skillnad på att skriva en wiki eller att skriva en kommentar i källkoden.

[00:22:35] Sofia: Exakt.

[00:22:36] Madde: Så det beror ju på. Nej

[00:22:38] Sofia: men jag vet inte. Det är väl rent krasst så här, varför det är viktigt när man jobbar är ju för att du ska ju dokumentera ditt arbete så att någon annan kan ta över.

Alltså bussfaktorn finns, jag sa det häromdagen, det var någon som inte visste vad det var, men alltså om du blir överkörd av en buss. Så är det ingen som vet vad du höll på med och i många branscher så är det nödvändigt att dokumentera olika typer av saker tänk

[00:23:07] Madde: om en läkare, nu tar vi en läkarexemplet men tänk om de inte skulle föra journal liksom, utan bara förlita sig på att man kommer ihåg men tror du att det var den här diagnosen jag ställde?

[00:23:17] Sofia: Ja Det olika nivåer på vad du behöver dokumentera men jag tror att det är en del av en professionalism att man gör det. Det är ändå ett ingenjörsyrke och någon ska kunna följa upp det du har gjort. En situation från verkligheten, jag har en kollega som har hoppat på ett helt annat projekt på en annan avdelning för att hjälpa till.

Och de har jättestora problem och det enda han har gjort de senaste veckorna är att gå runt och bara prata med folk för att få tag på nycklar och inloggningsuppgifter till applikationer som ingen har koll på längre. Folk bara pekar på nästa person och nästa person och ingen minns någonting för det aldrig någon som har skrivit ner det.

Någon kanske har skrivit ner det i en egen notesfil och det tycker jag är jättevanligt att folk dokumenterar för sig själva Ja, men de tänker aldrig på att den andra personen kanske inte vet var API-nyckeln är någonstans.

[00:24:20] Madde: Exakt. Det tycker jag är ganska nice, en form, jag vet inte om man skulle kalla det dokumentation, men att köra till exempel en gemensam key vault för nycklar kan man ju göra.

Ja,

[00:24:31] Sofia: ja. Men så måste man ju också säga att den finns. Ja För folk har ofta det. Ja, eller hur? Nej men det är väl såhär, alltså... Att spara tid och pengar är väl egentligen det slutända varför vi dokumenterar.

[00:24:47] Madde: Och det sjuka är att man tror ju att det är tvärtom. Man tänker så här, det kommer ta så lång tid att dokumentera Vi kommer inte att bli klara.

Vi måste pusha ut lite Prod ASAP och sånt. Men ja, som sagt, det är ju en investering faktiskt. Och jag vet själv också. Vi var faktiskt ganska duktiga och skrev en sån runbook. Det är också en form av dokumentation som är verkligen... Om allting bara går ner Hur får du upp systemet och snurra liksom. Och sen fick vi.

Detta var förvisso. Som en brandövning Fast en övning i att systemet gick ner. Att vi hade blivit hackare. Så då fick vi ju verkligen köra vår. Nej playbook heter det inte runbook. Eller vad heter det egentligen? Det

[00:25:31] Sofia: jag jobbade i heter typ en disaster recovery plan.

[00:25:34] Madde: Ja precis. Så vi fick i alla fall köra igenom den runbooken Eller playbooken.

Vad det nu heter och se liksom och det var ett jättebra sätt att se att vi faktiskt hade fått allting på plats jag tror till och med vi upptäckte att det var en sak som vi inte hade dokumenterat och bara såhär okej då vet vi att om det verkligen händer så får vi lägga, eller såhär, vi la in det det är skönt när sådana övningar är

[00:25:58] Sofia: bra ofta så krävs det nog att någon någon annan kräver att du gör det för teamet kommer inte göra det

[00:26:06] Madde: Nej.

[00:26:07] Sofia: Men okej frågan är ju ofta typ såhär, hur skriver man en bra dokumentation då? Eller vad, alltså du beror ju på vad det är du ska dokumentera skulle jag säga. Ja, och för

[00:26:19] Madde: vem på

[00:26:20] Sofia: något sätt?

[00:26:21] Madde: Alltså är det... Använda dokumentation typ för slutanvändaren eller är det för teamet själv? Alltså är det för en utvecklare som ska läsa det?

Eller är det en produktägare som behöver känna till det?

[00:26:32] Sofia: Jo men hur du sätter upp ett system det är väl skitbra eller? Det är väl det vanligaste som kan saknas. Du öppnar ett repo och det står bara såhär Det finns en readme-feed men den är tom. Eller så har du den här genererade typ... Jaja,

[00:26:47] Madde: om du har kört typ såhär Create React-app eller någonting så har du deras readme typ.

Och

[00:26:53] Sofia: då blir man såhär, ja här

[00:26:55] Madde: har

[00:26:55] Sofia: folk inte brytt sig alls.

[00:26:58] Madde: Okej men får jag ta den som exempel då? Ja. Skriv liksom bara ja... Alltså jag älskar när det är så himla alltså verkligen for dummies att det står typ såhär steget klona repot. Alltså det är klart man vet att man ska klona repot men det är så skönt att bara följa steg för steg utan att ens behöva tänka.

Okej jag ska klona repot, jag ska typ såhär se det in i mappen Jag ska köra npm install eller whatever. Alltså nu är det ett väldigt enkelt exempel. Oftast är det ju ganska Men det där är ju viktigt

[00:27:30] Sofia: för det är ju ofta du kan ha olika att du behöver stå i olika typ paket och installera någonting på olika paket.

Alltså i många språk kan du behöva installera olika typ såhär .net-versioner i olika mappar eller hur? Då är det jätteviktigt att det är såhär jätte... Specifikt. Ja, för du kan inte bara köra en bild på typ hela.

[00:27:59] Madde: Det

[00:27:59] Sofia: kan

[00:27:59] Madde: vara att man behöver ha olika versioner, absolut. Så att ja, det är definitivt bra att dokumentera det, tycker jag.

[00:28:07] Sofia: Ja men också typ så här, du vet, exakt vilken version av språket, eller runtime behöver jag ha? Är det några andra verktyg jag kommer att behöva när jag använder det här projektet, typ typ Behöver jag. AVS. Command line tools. Eller Azure command line tools. För jag kommer ändå behöva köra Ett kommando med det senare Alltså.

Hjälp med att sätta upp med min miljö och förutsätt inte att jag har koll. Jag

[00:28:40] Madde: tror att många förutsätter just att det känns lyligt att skriva vilket att du kan använda typ såhär, Azure har ju någon sån vad heter det program där du kan kolla på alla resurser i ett gränssnitt minns inte vad det heter nu så länge sedan var jag använde det men förutsätt inte att alla känner till det utan skriv liksom Ja, här kan du gå in i Blomstorch och titta.

[00:29:04] Sofia: Ja, och det är också typ okej det här projektet använder Azure. Det är inte alltid folk har skrivit det. Du vet såhär, all infrastruktur är skriven i Terraform. Det kan vara lite svårt att Förstå vart det deployas, men skriva till Azure, men också om jag aldrig har använt Azure innan jag kanske är jätteerfaren cloud-utvecklare men jag har aldrig använt Azure alltså det är svårt för mig ens att veta hur jag navigerar till portalen för vad är ju adressen till den?

Ja, det är så mycket som

[00:29:43] Madde: ofta saknas tycker jag Jag tänker hellre att ha lite för detaljerat För om man redan kan det så är det väldigt lätt att skippa det och skumma vidare. Och bara säga att jag vet att du ska köra en PM-install. Sen är det klart att du inte kan gå in på varenda liten detalj. Man får ju på något sätt förutsätta att folk vet hur du öppnar en terminal.

Första instruktionen i din guide kan ju inte vara att installera iTerm eller PowerShell.

[00:30:11] Sofia: Nej, men där är det så här... Någonstans där jag drar gräns också för vad som är när du börjar dokumentera för mycket det är när folk säger kanske såhär vi använder det här speciella biblioteket och sen börjar man förklara hur biblioteket fungerar gör inte det för att det biblioteket har antagligen en väldigt bra dokumentation typ vi använder Next.js nej berätta inte om hur Next.js funkar nej Länkat då kanske till Next.js bara och så kan man läsa om det det där tror jag är ett problem för folk att Att man överförklarar det som är väldigt lätt att förklara men det är det onödiga Och sen glömmer man att förklara det som är lite svårare, det som du bara gjorde en gång när du började i det här teamet och nu har du glömt det.

Ja,

[00:31:12] Madde: precis. Ja Och sen tänker jag också att man ska väl bara skriva någonting översiktligt om vad systemet gör. Vad finns det för komponenter i det? Som du sa Azure men det kan ju också vara att finns någon messagebass som gör någonting. Någon form av arkitekturell karta kan vara ganska skönt att veta hur allt hänger ihop.

Särskilt om detta är saker du ska köra lokalt också. Om du behöver ha en jag vet inte en function som ligger och snurrar i bakgrunden för att den ska kunna processa någonting så det är väldigt bra att känna till så man inte sitter och väntar, men varför dyker inte min senaste order upp till exempel så det känns också viktigt

[00:31:56] Sofia: ja men det missar man, eller hur alltså det märkte jag på vår egen kod vi har ju helt nystartat projekt och så Var det en person som hade satt upp det mesta och dokumenterat väldigt bra hur man installerar allting och hur man startar allt.

Men sen saknades det i dokumentation för att till exempel, okej så hur testar jag det här API-et?

[00:32:18] Madde: Vad

[00:32:19] Sofia: behöver jag sätta för headers och vad är för typ av autentisering jag behöver sätta in? Så sitter man där, då sitter man dum och behöver gå och fråga. Ja. Och finns inte den personen på plats helt plötsligt, det kanske är en konsult som slutar då hamnar man i det så typ det

[00:32:40] Madde: är lite det man ska sträva efter typ såhär, dokumentera för att du ska slippa gå och fråga saker sen kommer jag aldrig kunna undvika det helt såklart och alla har ju olika funderingar, men nej det finns ju

[00:32:52] Sofia: det finns ju också en bra sak i att såhär lämna lite till Jag vet inte, samarbete det är bra att personen som är ny går och frågar eller det behöver inte vara en ny, men någon som ska röra den här nya delen av kodbasen

[00:33:11] Madde: Men ja det är ju en fin avvägning på något sätt, för ju mer dokumentation desto mer ska det också underhålla Och det kanske är där ofta man fallerar så vet jag att det har varit i team jag har varit i att man har gjort en liksom rädd och bara nu jäklar ska vi dokumentera och så har man fokuserat på det i typ någon sprint eller någonting och sen bara håller man trevlig liv och så blir den ju ouppdaterad istället och det nästan värre när man har dokumentation som är föråldrad och fel för då sitter man aha jag ska göra så och så och sen bara, va?

funkar inte alls

[00:33:45] Sofia: Ja, nej den är inte rolig. Jag vet att du tänkte fråga mig vad mitt favoritexempel på bra dokumentation är men jag kan bara komma på dåliga och särskilt det jag jobbar med själv och där har vi Ashers dokumentation som verkligen kan vara föråldrad. Jag har uppskrivet tre grejer som jag ska gå in och ändra i deras dokumentation.

[00:34:10] Madde: Alltså typ

[00:34:11] Sofia: en

[00:34:11] Madde: PR

[00:34:11] Sofia: på,

[00:34:11] Madde: menar

[00:34:12] Sofia: du eller? Ja, det är små saker, men det är så här vissa saker måste vara specifika specifik casing.

[00:34:22] Madde: Och

[00:34:22] Sofia: så är någon som har skrivit fel. Det står typ så här, kryssa in den här konfigurationsfilen så kommer allt att funka.

[00:34:28] Madde: Och

[00:34:29] Sofia: så har det jättelång tid att förstå varför funkar inte det här?

Och då är det någon som har Casingen är fel. Vad störigt. Shit vad irriterande. Det är sånt man inte riktigt ser direkt heller ju. Nej hur ska ju jag veta? Det är första gången jag läser det. Alltså såna grejer. Eller att de bara har tre versioner Alltså olika personer har skrivit om samma sak. Ja

[00:34:52] Madde: Ja, det sant.

Och ens prata om deras maskinöversatta när de hittar på random namn för saker och ting.

[00:35:00] Sofia: Ja, jag har inte att det gäller all Microsofts dokumentation. Ja,

[00:35:05] Madde: inte specifikt Azure. Nej. Överlag så tycker jag att dokumentation skrivs på engelska även om man är ett svenskt team, tycker jag nog. Ja, jo, det...

[00:35:20] Sofia: Jag kan tänka mig ändå att små bolag, jättesmå där alla är svenska, att de kanske inte gör det.

För det blir så himla konstigt, känner de. Det finns ju ganska bra verktyg idag som översätter allting om mot förmodan någon stackare skulle börja.

[00:35:38] Madde: Jo, så är det ju. Men jag tycker det är så onaturligt att prata om kod på något annat än engelska Ja, då måste du ändå slänga in engelsk terminologi och så blir det väldigt kryssat.

Och nej jag tycker engelska i alla fall.

[00:35:54] Sofia: Men det där är svårt Jag förstår om du och jag hade startat ett litet bolag, då hade vi säkert skrivit saker i vår readme på engelska Saker vi hade haft i vår delade notion, där man antecknar en konferens. Osäker på om du hade skrivit saker på engelska.

[00:36:17] Madde: Nej, det tror jag nog inte vi hade gjort.

[00:36:19] Sofia: Och olika user stories och sånt där. Nej förvisso. Men det funkar ju då med generativ AI och hur väl den faktiskt översätter saker så att det blir flyt i det. Ja. Så

[00:36:37] Madde: funkar det ju ändå. Ja, det är ju inte som Google Translate som översätter ord för ord. Och så blir det någonting jättekonstigt i slutändan.

Ja jättekonstigt.

[00:36:44] Sofia: Men en annan typ av dokumentation som jag vill nämna här. Som jag har lärt mig mer om de senaste två åren. Är ju den här dokumentationen som inte är i repot. Utan som ofta är i din... Confluence, jag vet inte vad det heter när man sitter på andra plattformar men jag tror att alla vet vad Confluence är.

Alltså det är bara ett dokumentations...

[00:37:10] Madde: Ja, wiki. Det kan vara Notion det kan vara liksom, ja.

[00:37:14] Sofia: Ja, och det är den här typ systemdokumentationen som beskriver hur ditt system fungerar som jag tycker är, du nämnde ju den lite att den vill man gärna se Det räcker inte med att bara säga här är koden. Du vill också förstå okej så när jag har utvecklat något, hur vart deployas det?

Och hur ser komponenterna i det systemet ut? I till exempel målet eller om präm. Vad är det för typ av, liksom sitter en databas någonstans? Hur angränsar vi till andra system? Alltså Egentligen så mycket som möjligt när man satt och funderade på när man tog fram det här nya systemet alla de här designvalen man gjorde så att du förstår att okej den här databasen är en SQL-databas och vi behövde en relationsdatabas för att det här var de funktionella kraven på systemet alltså sånt.

Ja. Det är så lätt att man sitter där efteråt och bara åh

[00:38:27] Madde: fy, hur tänkte de där?

[00:38:29] Sofia: Ja,

[00:38:30] Madde: det kan jag visa dig. Nej men det är ju typiska saker som man vill ha i typ confluence och liknande system eller någon wiki. För det finns ju ganska många som är av åsikten att Man behöver inte dokumentera för koden ska vara självförklarande.

Och jag berättar ju ingenting om sådana saker, eller hur? Nej exakt. Och självklart ska man ju fortfarande sträva efter att skriva bra kod som är självförklarande och självdokumenterande. Men det är ju för det kontextet på något sätt att... Men kodkommentarer och sånt är ju bra också för detaljer om det är någon specifik funktion som kanske inte är jättetydlig vid första anblick att man behöver förklara någonting.

Men som du säger, helheten behöver man ju ha i separata dokument typ.

[00:39:15] Sofia: Ja, men det är olika nivåer som när man pratar om testning att... Du har unit-testerna, du har interaktionstesterna, du har end-to-end-testerna. Alltså det är olika nivåer du måste dokumentera på. Men ett annat ord för de här system...

Jag tänker en systemdokumentation, det finns bara ett sådant dokument. Som också kanske har lite olika nivåer. Men det finns en annan sak som ofta heter RFC. Eller RFC. Eller Design Doc. RFC, det är

[00:39:50] Madde: väl Request for Comments, eller är det något annat sammanhang här?

[00:39:54] Sofia: Request for Change står just de här för. Ja, det är det kanske.

Jag tycker det låter lite konstigt. Vi har valt att kalla det Design Doc i vårt team. Och det är just såhär, Design Doc och inte Design Document, vilket också är lite konstigt. Men det är ett sätt att dokumentera ofta Teknisk dokumentation till någon typ såhär ny feature och det här är sjukt bra och det finns det är väldigt fritt hur man gör det du kan liksom bara skriva några rader om någonting, hur du tänkte lösa något och vem som är mottagaren av det här dokumentet kan vara jätteolika, det kan bara vara för att skriva ner lite för sig själv såhär tänkte jag lösa den här featuren det kan vara för att Skriva ner för sig själv och kunna komma ihåg dagen efter när du ska förklara för dina kollegor eller så kan det vara för att du behöver lyfta dig högre upp och få ett beslut av någon arkitekt ovanför eller någon chef när det är mer påverkar organisationen att du säger nej men vi ska migrera allting till ett helt annat språk och de här Är superbra.

Jag kommer länka till Googles guide om hur de skriver design docs. Okej så de har liksom som en typ mall för det eller vad man ska kalla det. Ja, de flesta eller typ alla stora företag Små också, men alla som har fantastiska produkter som vi känner till använder RFCs eller Design Docs, alla, alla alla och de har olika mallar och team har olika mallar på hur man gör det men oftast så är det i alla fall du kanske skriver, vem som har skrivit dokumentet, vem har signat liksom sign-off på det, vilket kan den här högre arkitekten eller chefen som gör en sign-off och så innehåller det bakgrund och Kanske kontext och avvägningar vad för olika saker har jag liksom du vet det finns ofta att Två, tre olika lösningar du kan ta.

Och sen vad man kommit fram till. Men

[00:42:19] Madde: det är ändå ganska, alltså det kan vara väldigt bra att veta varför man inte valde en lösning också. För det så lätt när man kommer sen som utvecklare och bara, varför tänkte de inte på att lösa det på det här sättet? Det är ju mycket enklare. Då kan man ju se, nej vi valde inte det sättet för det gav de här implikationerna.

Exakt.

[00:42:36] Sofia: Och det är där jag tyckte att det var mest, mest mest användbart av allt. Är kanske inte såhär i det direkta teamet. För har man bra kommunikation. Det har vi ju redan pratat igenom det. Där kan det ju mer vara för att man glömmer. Det blir såhär. Varför valde vi nu igen det här? Eller om man får in någon annan

[00:42:54] Madde: medlem eller någonting.

[00:42:56] Sofia: Ja det kan vara för nyfikenhetens skull. Om båda folk. Men där det är mest kraftfullt tycker jag att. Om du behöver gå högre upp. Utanför ditt team. För något beslut du behöver hjälp med. Personerna du går till. Det ofta. Väldigt upptagna människor. Det mest proffsiga du kan göra där är att du skriver ihop alla dina tankar.

Vad är det du vill prata om? Vad är det ni har funderat på? Har du själv proposal? Vad man borde välja för alternativa av de du har argumenterat för. Du skickar det till den här personen i typ mötesinbjudan eller i slacken eller någonting innan det lilla mötet ni har. Då behöver det här mötet ni har bara vara Kanske en kvart, kanske 30 minuter, eller så får du ett beslut utan att mäta överhuvudtaget.

Utan att mäta, och de här personerna blir oftast väldigt, alltså de tycker om det. För det sparar deras tid också, du visar liksom att det här är ett väl genomtänkt beslut. Det blir väldigt professionellt faktiskt. Det är det,

[00:44:05] Madde: mm.

[00:44:06] Sofia: Det är så pro-tips om man vill bli uppskattad och sedd mer som ordentlig och senior.

Jag

[00:44:16] Madde: skulle precis säga att det är en sån typisk grej som gör att man känns mer senior. Eller är mer senior. Men mallar är ju alltid nice också att ha. Alltså det minskar ju tröskeln för att... Dokumentera om du vet att du har en specifik mall att följa. Så det kan ju vara en bra sak att tänka på om man nu jobbar i ett team där det går lite trögt med dokumentationen och att man kanske inte riktigt får sina teammedlemmar att vilja dokumentera.

Men ja, vad kan man mer göra då för att få sina teammedlemmar att bidra till dokumentationen? Jag tycker jag hör mycket, alltså när du berättar i alla fall så är min känsla av att du leder med exempel alltså på något sätt att du försöker dokumentera mycket för då Då är det lättare för de andra att se.

Alltså det är svårt att klaga. Det är ingen som dokumenterar så gör man inte det själv heller.

[00:45:05] Sofia: Ja. Men där ska jag väl också säga att. Det funkar väl bra och dåligt också. Det är ju inte alla som. Det är inte alla som vill dokumentera. Och sen. Har jag kanske haft utmaningen att. Jag leder med mitt exempel.

Men. Så som jag dokumenterar. Är inte alltid så som jag kräver att. Du då kommenterar. Det viktiga är att det finns någonting. Och där har det ändå varit kanske diskussioner om att. Det är så onödigt att skriva så mycket. För det är det det krävs träning för att. De personerna ska förstå att. Nej. Du behöver inte skriva en hel uppsats.

Som jag gjorde för den här ändringen För att det här är någonting. Som behövde många ord. Eller så här. Det du gör. Behöver inget designdokument alls För det räcker med att du skriver i ticketen vad det är för bug eller sådär. Men ja, leda med exempel så tror jag är bra. Men det är väl mer morot än piska.

Men jag tror att piskan behövs också.

[00:46:17] Madde: Ja, men någonstans måste man ju också ha Dels som någon form av ledare sätta ner foten att detta ska göras. Alltså det kanske ska vara en del av definition of done till exempel att det ska vara dokumenterat på det sättet som är vettigt för just den här typen av kod liksom eller vad det kan vara.

Och det kan ju vara olika som du säger beroende på vad det är Är det en liten bugg eller är det någon stor arkitekturförändring Det är klart det kräver olika typer av dokumentation. Men att ändå liksom Det ska ändå finnas med i ens tankar när man utvecklar att det här ska dokumenteras på något sätt.

[00:46:54] Sofia: Ja. Tycker inte du att organisationer eller team där man inte dokumenterar de här mindre besluten det är också där man inte ens dokumenterar stora arkitekturella beslut. I de organisationerna så går arkitekten och snackar med Lisa och Niklas som är enterprise-arkitekter och lite så, kommer fram till något och säger, ja vi gör så här.

Och det finns inget spår av det. Det är i alla fall det jag har upplevt. Det är faktiskt sant. Det kommer från toppen och från botten hur man jobbar. Vi

[00:47:38] Madde: fick ju också fråga jag tänker jag bara gick tillbaka och kollade vad egentligen de frågade efter. De frågade om vi dokumenterar våra egna hobbyprojekt.

Vi har ju inte ens hobbyprojekt. Nej, men i de fallet... Jo har

[00:47:52] Sofia: väl hemsida och har haft, eller vi har haft en egen hemsida och har haft lite hobbyprojekt när man ändå försökt vara som Vi körde ju

[00:48:02] Madde: Developers hemsida tidigare, gjorde vi en egen. Och då fick vi faktiskt en pull request från en lyssnare som dokumenterade åt oss.

Kommer du ihåg det?

[00:48:14] Sofia: Ja, och vi såg inte den pull requesten på typ två månader, jag vet inte. För vi kallade in. Nej, jag hade nog inte dokumenterat för mig själv. Inte bara i en själv? Nej. Det hade ju varit mer typ såhär man kanske har ett dokument där man sparar lite såhär länkar och lite lösnord eller något sånt.

Jag

[00:48:40] Madde: hade inte skrivit en typ readme hur du sätter igång och startar projektet och allt sånt kanske.

[00:48:46] Sofia: Men det är väl, jag vet inte vad man menar heller, för är det publikt? Är det någonting såhär att jag har kommit på ett litet fräckt Chrome-plugin? Jo men då hade jag ju skrivit. För jag vill ju att folk ska ladda ner och jag förklara vad det är.

Absolut.

[00:49:02] Madde: Jo men det är, ja. Som sagt, ja det har kanske att göra med det då. Vad man, vem som ser det. Är det verkligen ett hemligt repo som bara du har tillgång till så? Nej. Men det är väl lite som såhär Alltså

[00:49:14] Sofia: skilja på arbete och fritid. Det inte som att jag dokumenterar ju inte med min familj. Om vi har kommit överens om...

Fast man borde göra

[00:49:29] Madde: det ibland

[00:49:30] Sofia: känner jag. Jo kontrakt behövs fan ibland. Men det är inte såhär att vi ska ha nya levnadsvanor i år. Men låt oss skriva ett designdokument om det. Man kanske borde. Jo men det är det. Man gör inte det. Precis som att man är inte duktig på att ge strukturerad feedback hemma

[00:49:56] Madde: Nej, det svårt att skilja på.

Eller så här. Det är inte riktigt jämförbart kanske.

[00:50:03] Sofia: Vi hade ju någon kollega som ändå körde De körde väl Scrum hemma under ett tag? Ja men det har jag sett

[00:50:10] Madde: flera som gör. Jag har kört retro hemma också. Det tycker jag faktiskt är väldigt kul.

[00:50:15] Sofia: Ja, okej Men heter inte det mer typ så här... Vad heter det?

Alltid på film så sätter familjen sig i en ring och så ska de ha en sån snack.

[00:50:27] Madde: Familjeråd typ.

[00:50:27] Sofia: Ja,

[00:50:29] Madde: det är en det. Eller så ska man ha... Vad heter det? Intervention Ja, men är inte det mer om någon har missbruksproblematik och så ska du ha en intervention? Jag tycker du dricker för mycket, eller spelar för mycket.

Ja,

[00:50:42] Sofia: men lite är det ju ett retro för alla andra förutom den som är...

[00:50:46] Madde: Men det ju lite fasligt om man pekar ut en person.

[00:50:51] Sofia: I ett retro liksom. Nej men jag menar det är det jag har sett i privatlivet Interventions.

[00:50:57] Madde: Ja nej Nej alltså när vi har kört där hemma så har vi ju kört typ såhär. Mad, glad, sad typ.

Och då lyfter man ju också upp de bra sakerna. Så att det blir inte så känsligt att. Nu ska vi ha ett retro här för att du ute med diskmaskinen för sällan

[00:51:11] Sofia: Ja. Men har det kommit ur att. Du bara såhär, allt är skitbra och du vill bara testa något kul Nej

[00:51:20] Madde: men detta var på nyårsafton faktiskt som vi gjorde det inte nu i år, det var tror jag förr eller förr som liksom såhär lite års blicka tillbaka

[00:51:31] Sofia: Ja men det har jag hört många gör absolut Det kanske inte är retro ofta för folk.

Du är väl bara jobbskadad? Ja,

[00:51:39] Madde: förmodligen.

[00:51:40] Sofia: Men

[00:51:41] Madde: en årsrevy

[00:51:42] Sofia: typ? Jag tror inte de sitter heller

[00:51:43] Madde: med post-it-lappar och sorterar upp i olika kategorier och sånt.

[00:51:47] Sofia: Nej, oftast är det väl ett samtal när man blickar tillbaka Jag vet att jag tycker det är synd jag antar att vissa familjer gör det gud vad vi går ifrån ämnet vi är väl ganska klara jag tror det, alltså visst man kan säga

[00:52:03] Madde: jättemycket om dokumentation men jag tror vi har fått med vi har just

[00:52:06] Sofia: pratat om publikdokumentation i stora projekt och så men låt oss avsluta det här innan vi går över en timme

[00:52:14] Madde: det har blivit många långa avsnitt nu Ja, vi snackar för mycket.

Hoppas i alla fall att det var lite till hjälp för er som är nyfikna på dokumentation och som kanske inte har direkt jobbat i ett team som dokumenterar så mycket.

[00:52:30] Sofia: Ja, och det finns så mycket att säga om alla delar så man kan ju prata om design dock eller dokumentation av kod väldigt länge också. Men tycker ni att det toppen så kan vi prata mer om det.

Det är svårt att få med... Det är svårt att gå in djupt och seriöst känner jag, om jag inte bryter ner det.

[00:52:49] Madde: Det är sant. Men ja, det sista som jag vill säga är att försöka göra det enkelt. Gör inte så himla stor greja av det, utan bara kom igång med någonting. Det är bättre än ingenting. Gör en

[00:53:00] Sofia: rutin.

[00:53:02] Madde: Men vi hörs nästa vecka som vanligt Det gör vi.

Ha det

[00:53:07] Sofia: bra. Ha det bra. Hejdå.

Skapare och gäster

Madeleine Schönemann
Värd
Madeleine Schönemann
Madde är en riktig allrounder! Hon har haft många roliga och lärorika roller inom branschen, som utvecklare, scrum master, product manager, konferensarrangör och föreläsare på flera olika evenemang. Programmering ligger henne varmt om hjärtat och hennes stora glädje är att tillsammans med sitt team leverera produkter som gör verklig skillnad för användarna.
Sofia Larsson
Värd
Sofia Larsson
Sofia är en erfaren utvecklare som tycker om att vara en del av produktupptäcktsfasen och skapa effektiva lösningar med användaren i fokus. Hon har ett starkt engagemang för digital hållbarhet och i sin roll som Digital Sustanability Competence Lead jobbar hon för att öka det digitala mijömedvetandet. LinkedIn
image of podcast supporter image of podcast supporter image of podcast supporter image of podcast supporter image of podcast supporter
Bli en av 34 supportrar