Programmets dokumentation behandlas vanligen som en resultatdel — de handlingar som måste tas fram eftersom en inköpsorder har undertecknats. Det är mer användbart att behandla den som programmets enda hållbara minne. Sex månader in i lanseringen av ett eget varumärke är det filen som berättar för en kollega vad som har avtalats, vad som har mätts och vad som har godkänts. En fil som inte besvarar de här tre frågorna är ett arkiv, inte ett styrverktyg.
Standardmässig OEM-dokumentation inom den här kategorin har en ovanlig form, och formen kommer från katalogen. Det publicerade materialet är rikt på specifikationsrader och nästan tyst om det som en programfil faktiskt behöver: inga referensvärden publiceras för någon post, inga toleranser, inga godkännandeformer, ingen minsta orderkvantitet, inga priser, inga tidsplaner och ingen certifieringsrad per modell. En dokumentuppsättning för den här kategorin måste därför vara större än den skulle vara för en produkt med en fullständig offentlig specifikation, eftersom mer av den måste skapas i stället för att samlas in.
Följande beskriver den uppsättningen — vad varje dokument fastställer, vem som skriver det, när det avslutas, vilka som endast finns därför att en leverantör har svarat på en fråga skriftligen och hur filen hålls konsekvent när en produktionsbatch har startats.
Den dokumentuppsättning som ett OEM-program faktiskt använder
En programfil är inte ett enda långt dokument. Det är en uppsättning kortare dokument, som var och en har en ansvarig och en uppgift. Den disciplin som håller den användbar är att ett dokument som inte fastställer något är en registrering, inte ett dokument, medan en registrering som förvaras i en chatttråd inte alls är ett dokument.
| Dokument | Vad det fastställer | Ansvarig | Avslutas när |
|---|---|---|---|
| Kravspecifikation | Modell, marknader, färgvarianter, claimsamling | Köpare | Har undertecknats av köparen |
| Register över öppna frågor | Alla obesvarade frågor, med en ansvarig och ett datum | Köpare | Varje rad har ett bifogat svar |
| Skriftligt omfattningsdokument | Leverantörens svar utifrån kravspecifikationen | Leverantör | Har avtalats av båda parter |
| Godkänt grafikunderlag | Det godkända grafikunderlaget för en namngiven komponent | Båda | Refereras i versionsnoten |
| Godkännandeformulär | De villkor som en enhet bedöms mot | Båda | Har undertecknats efter första provpartiet |
| Claimsamling | De påståenden som får göras om enheten | Köpare | Har granskats tillsammans med underlagen |
| Skriftlig offert | Pris, minimi, tidsplan för ett angivet omfång | Leverantör | Har lämnats för ett fastställt omfång |
| Batchregistrering | Vilka enheter, vilka dokument, vilken version | Leverantör | Har lämnats tillsammans med batchen |
| Förpackningslista | Vad som fysiskt finns i lådan | Leverantör | Har avstämt mot kartongen |
| Fraktfil | De dokument som följer med varorna | Leverantör | Arkiveras vid avsändning |
Läs kolumnen med ansvariga uppifrån och ned, så framträder ett andra mönster. Köparen ansvarar för fyra dokument, leverantören för fyra och två delas. Balansen är viktigare än den verkar: de dokument som köparen ansvarar för uttrycker avsikt och bedömning, medan de dokument som leverantören ansvarar för registrerar vad som faktiskt har utförts. Ett program där köparen inte ansvarar för något av de gemensamma dokumenten slutar lätt med en inköpsorder men ingen godkännanderegistrering — formen av en tvist som väntar på att inträffa.

Vem som skriver varje dokument och när det avslutas
Det vanligaste dokumentationsfelet är inte ett saknat dokument. Det är ett dokument som aldrig avslutas — som finns i utkast, omnämns på ett möte och aldrig får det som gör det bindande. Varje dokument ovan avslutas på ett annat sätt, och att ange avslutsvillkoret är det som hindrar en fil från att fyllas med utkast som alla antar är färdiga.
Kravspecifikationen avslutas med en underskrift
En kravspecifikation är klar när köparen har undertecknat den, och underskriften är inte bara en formalitet. Den är den punkt där köparen förbinder sig till ett omfång, och varje fråga som köparen väljer att inte skriva ner blir en fråga som leverantören kommer att besvara på sina egna villkor. Kravspecifikationen bör därför innehålla både det som köparen känner till och det som köparen inte känner till, med den senare gruppen angiven som frågor i stället för att utelämnas.
Registret över öppna frågor avslutas rad för rad
Registret är det billigaste dokumentet i uppsättningen och det mest användbara. En rad per fråga, med datumet när den ställdes, vem som ansvarar för svaret, vad svaret var och vad svaret förändrade. Det avslutas rad för rad i stället för på en gång, och ett register med en synlig svans av öppna rader är ett tecken på att programmet fungerar, eftersom svansen utgör en tidsplan.
Det skriftliga omfattningsdokumentet avslutas vid avtal, inte vid mottagande
Ett omfattningsdokument som har skickats är inte samma sak som ett omfattningsdokument som har godkänts. Avslutsvillkoret är att båda parter har gått igenom det och att köparen har markerat de öppna punkterna i det. Skillnaden är vad som hindrar ett program från att upptäcka i den första artikeln att leverantören och köparen arbetade utifrån olika dokument.
Konstfiler frigörs genom hänvisning
En konstfil avslutas med ett frigöringsmeddelande som anger filen, revisionen, den del den gäller och den konfiguration den ritades för. Att avsluta konst genom hänvisning i stället för som bilaga gör det möjligt att revisionsspåra en batch, eftersom frigöringsmeddelandet är det som en fabrik kan kontrollera mot enheten i kartongen sex månader senare.
Godkännandeformuläret avslutas med en signatur, och först när enheten finns
Ett godkännandeformulär som skrivs före den första artikeln är en lista med avsikter. Ett som skrivs efter den, utifrån angivna kriterier, är det enda dokument som kan användas för att avvisa eller godkänna en produktionsbatch. Det är det dokument som alltför ofta utelämnas i program för eget varumärke, och anledningen till att det utelämnas är att provet vanligtvis klarar inspektionen. En köpare som saknar ett signerat godkännandeformulär saknar även en referensenhet, och en produktionsbatch utan referensenhet bedöms utifrån köparens minne.
Batchdokumentationen är den ingen planerar för
Batchdokumentationen – vilka enheter, vilka dokument, vilka revisioner och vilket prov den godkändes mot – skapas av fabriken och är dokumentet som gör det möjligt att utreda ett reklamationsärende. Den saknas också oftast, eftersom den inte är någons leverans i en köprelation. Frågan man ska ställa är enkel: vad utfärdar fabriken med varje batch, och identifierar den enheterna utifrån den godkända första artikeln?
Vilka dokument som enbart finns efter ett svar från leverantören
Flera dokument i en programfil finns av ett enda skäl: katalogen publicerar inte det som dokumenten registrerar. Det är inte en kritik mot katalogen. Det är en specifikation, och råkar vara en specifikation av en produkt i stället för av ett program. Köparen måste uppmärksamma skillnaden och medvetet skapa de saknade dokumenten.
Dokumentet med referensvärden och toleranserna. För ingen av posterna anges något referensvärde för färg, ytbehandling eller toleransintervall, inte heller för de två kameraposterna med publicerade färgnamner. Ett färgnamn är en etikett; en referens är ett mål som kan bedömas. Documentet måste finnas innan den första artikeln kan bedömas, och det måste ange betraktningsförhållandena och jämförelsemetoden, eftersom en bedömning utan dessa två uppgifter bara är en åsikt.
Godkännandedokumentet. För ingen post publiceras några godkännandevillkor. Villkoren måste skrivas av parterna, och de fyra element som gör dem användbara är betraktningsförhållanden, jämförelsemetod, provstorlek och en angiven konsekvens vid avvikelse.
Beslutet om packningslistan. För fem kameraposter publiceras en kapacitet per kartong; ytterligare två visar en kartong utan någon angiven kapacitet; och fyra saknar helt en kartongrad. För de fyra sista posterna är det en öppen fråga om ett tillbehör ingår i leveransen, och det måste registreras i packningslistan i stället för att antas utifrån modellnamnet. Samma dokument fastställer etiketten, informationsbladet och bruksanvisningen, eftersom alla måste stämma överens med kartongen.
Anteckningen om radioversionen. De åtta ljudposterna publicerar en radioversion, medan de elva kameraposterna inte gör det. En specifikationsblankett för en kameraprodukt har alltså ett tomfält, och det tomfältet måste fyllas i skriftlig form innan blanketten skickas till en kund.
Anteckningen om dokumentation av ingressskydd. Två poster har en IP54-märkning på sina sidor, och den interna dokumentationen anger att klassningen är en märkning som tryckts på sidan, utan något nummer för tredjepartstestrapport bakom den. En anteckning som registrerar detta förhållande hindrar marknadsföringsgruppen från att utfärda en garanti. Påståendena och underlagen måste granskas tillsammans, annars skrivs påståendena först och underlagen hittas aldrig.
Förklaringen av den tekniska filens täckning. Det finns ingen certifieringsrad per modell någonstans i katalogen, och CE, FCC och RoHS saknas helt i katalogtexten. En förklaring som bekräftar vilka dokument som täcker den beställda konfigurationen, och vilka förändringar som skulle leda till att enheten faller utanför deras täckning, är ett dokument som måste finnas för programmet och som inte finns i det publicerade materialet.
Dokumentet med ordervillkor. Inget på den kommersiella sidan återges i katalogen – det finns ingen publicerad minimikvantitet, inget publicerat enhetspris och ingen publicerad prislista för någon produkt, någon uppställning eller någon orderstorlek. Offertet är därför inte en återhämtning utan ett framtagande, och det måste knytas till en avgränsad omfattning, eftersom ett pris som baseras på en obestämd omfattning är ett tal utan mening.
Så utvärderar du en dokumentuppsättning innan du godkänner den
En köpare som har fått en uppsättning dokument kan bedöma den på cirka femton minuter, och kriterierna är värda att ange eftersom uppsättningen nästan alltid ser komplett ut vid första genomläsningen.
- Anger varje dokument en konfiguration? Ett dokument som inte anger vilken modell och vilken konfiguration det tillhör går inte att kontrollera mot en enhet, och det första kontrollsteget som misslyckas blir godkännandeformuläret.
- Har varje dokument en ansvarig person och en revision? Ett dokument som har varken det ena eller det andra går inte att uppdatera, så varje ändring skapar en andra version i stället för en ny version.
- Har varje dokument ett skriftligt slutförandevillkor? Om det enda slutförandet är en datumangivelse kommer dokumentet att behandlas som färdigt oavsett om det är det.
- Innehåller uppsättningen de dokument som katalogen inte kan leverera? En saknad publicerad rad är ett dokument som måste skrivas, och en uppsättning som tyst utelämnar den är en uppsättning med ett hål i.
- Är färgsättningarna och marknaderna räknade? Om antalet inte står nedskrivet är det inte planerat.
- Finns en överenskommen ändringsregel för en pågående sats? Om det inte finns kommer någon att hittas på under press, och de regler som hittas på under press är de som kostar mest.
Varningstecknen är desamma hos alla leverantörer: en fil utan index, en uppsättning dokument med samma ansvariga, en offert som kommer innan omfattningen är avgränsad och ett godkännandeformulär som i själva verket är en marknadsföringssammanfattning. Att jämföra två dokumentuppsättningar är därför inte en fråga om vilken som ser mer professionell ut, utan om vilken som en köpare kan förlita sig på i ett tvistemål.
Vad du ska fråga och när du ska fråga följer av samma lista. Be om index och godkännandeformulär tillsammans, eftersom en leverantör som har det ena nästan alltid har det andra. En leverantör som genomför Due diligence på sin egen dokumentation kommer att lämna tillbaka en uppsättning med revisionshistorik. En leverantör som sammanställer dokument på begäran kommer inte att göra det.

Hålla filen konsekvent genom en produktionssats
Konsekvens är inte ordning. En fil kan vara komplett och ändå inkonsekvent, och inkonsekvensen visar sig som en tvist i stället för som ett fel. Tre mekanismer håller en programfil synkroniserad när produktionen har påbörjats.
En ansvarig per dokument och ett enda index
Varje dokument behöver en ansvarig, och det ska vara en person, inte ett team. Indexet som binder samman dokumenten behöver ha en post per dokument med dess revision, datum och plats, och det måste vara den enda platsen som läsaren går till för att hitta något. En fil med tre index är en fil där två av dem är felaktiga.
Indexet måste också ange vilken konfiguration varje dokument tillhör, eftersom det är det fältet som brister först. En färglayout som godkänns för en färgsättning men tillämpas på en annan är den vanligaste varianten av detta fel, och den förblir osynlig tills kartongen öppnas inför en kund.
Uppsättningar per färgsättning och per marknad, uttryckligen räknade
Dokumentuppsättningen skalar med antalet färgsättningar och marknader, men inte med antalet enheter. Två färgsättningar på två marknader ger fyra uppsättningar med etikett, kartong, streckkod, informationsblad och fraktdokumentation. En köpare som har planerat en uppsättning har alltså planerat en fjärdedel av det som krävs. Att räkna uppsättningarna uttryckligen från början tar fem minuter och förhindrar en förpackningsförsening i programmets sista vecka.
Det finns en andra anledning till att hålla uppsättningarna åtskilda. En ändring i layouten för en färgsättning påverkar inte den andra, och om de två arkiveras tillsammans måste ändringen tillämpas på båda eller uttryckligen undantas från den ena. Att hålla dem åtskilda gör beslutet explicit och är det billigaste sättet att undvika en förpackningsförsening i programmets sista vecka.
En ändringsregel för satsen, överenskommen innan satsen körs
Regeln som bör överenskommas i förväg gäller vad som händer när ett dokument ändras efter att produktionen har påbörjats. Att pausa en batch, att fortsätta och märka de berörda enheterna respektive att kassera är tre olika beslut med tre olika kostnader, och de bör inte fattas mitt i en produktionsvecka av två personer som var och en antar att den andra sköter det.
Regeln behöver också ha en tidsgräns. En ändring som överenskommits innan batchen påbörjas är en ändring av omfattningen, medan en ändring som överenskommits efter att den har påbörjats är en variation med en kostnad och en tidplan. Att behandla den senare som om den vore den förra är hur ett program tappar kontrollen över sin egen dokumentation.

Vår hållning till programdokumentation
Vår hållning till programdokumentation är att vi tillhandahåller de dokument som beskriver vad vi gör, men inte tillverkar dokument som beskriver sådant vi inte har blivit ombedda att göra. Det innebär en skriven omfattning utifrån era krav, en offert utifrån den omfattningen, en godkännandeblankett för första artikeln, en batchjournal som identifierar enheterna mot det godkända provet samt en packlista som avstämts mot kartongen. Det innebär också att vi inte utfärdar ett intyg, en testrapport eller en försäkran om överensstämmelse som vi inte kan belägga, och vi anger tydligt vilka av dessa dokument som finns och vilka som inte finns.
Den andra halvan av denna hållning gäller köparens pappersmapp. När en fråga inte har något publicerat svar svarar vi skriftligen för en namngiven modell och en namngiven konfiguration, och vi anger vilket dokument som skulle behövas för att besvara frågan. Det är samma tresdelade struktur som används överallt inom denna kategori: vad som är publicerat, vad som inte är det och vad som skulle avgöra frågan. Ett program som håller isär de tre i sin register kommer inte att ägna sin första-artikel-vecka åt att ta reda på vilken version av specifikationen som var gällande.
En köpare som genomför due diligence av en leverantörs dokumentationsrutiner bör begära en frisläppt batchjournal från ett tidigare program eller en grafikfrisläppningsnotering för en modell som redan är i produktion. Båda är korta, båda är konkreta och båda visar mekanismen tydligare än någon beskrivning av en process.
Standard-OEM-dokumentation som arbetsmapp
Formulerat i en form som kan skickas till en kollega utan förbehåll: ett standard-OEM-program bygger på tio dokument – en kravspecificering, ett register över öppna frågor, en skriven omfattning, en grafikfrisläppning, en godkännandeblankett, ett kravunderlag, en skriven offert, en batchjournal, en packlista och en fraktmapp – och varje dokument har en ansvarig och ett villkor för avslut.
Sex av dessa finns bara för att katalogen inte publicerar det de dokumenterar: referensvärden och toleranser, godkändevillkor, beslutet om packlista för de poster som saknar en publicerad katalograd, radioversionen för kamera produkter, underlaget bakom den publicerade kapslingsklassningen och de kommersiella villkoren. Katalogen är rik på specifikationsrader och tyst om programdata, och en dokumentationsuppsättning som bygger på detta förhållande är större, inte mindre, än en som bygger för en fullständigt publicerad produkt.
Kriterierna för en hälsosam mapp är enkla nog att kontrollera på tio minuter. Varje dokument har en ansvarig och en revision. Varje dokument avslutas på ett villkor snarare än på en tidpunkt. Indexet har en post per dokument och den konfiguration det tillhör. Färgsättnings- och marknadsuppsättningarna räknas fram i stället för att antas. Och ändringsregeln för en pågående batch överenskommdes innan batchen påbörjades, inte under den.
Se vad en varumärkesguide måste avgöra för dokumentet som ligger först i mappen och fastställer omfattningen. Se ett program som drivs från kravspecifikation till frakt för ordningen i vilken dokumenten hör hemma.
Skicka det stadium ert program befinner sig i och den mapp ni redan har, så berättar vi vilka dokument som fortfarande saknas och vilka vi skulle behöva skriva.



