Kompatibilitetsnoter

Kompatibilitetsnoter är dokument som publiceras i samband med programvaru- eller hårdvarurelaterade lanseringar och som beskriver vilka miljöer produkten stöder samt eventuella kända problem och begränsningar. Syftet är att hjälpa användare, systemintegratörer och IT-administratörer att bedöma om produkten fungerar i deras miljö och hur risker eller kompatibilitetsfrågor kan hanteras.

Innehållet varierar men brukar alltid ange de operativsystem, hårdvarukrav, beroenden och versioner som stöds eller krävs, samt vilka konfigurationer som krävs för bästa funktion. Ofta finns även kända problem listade tillsammans med rekommenderade workarounds eller tidsplaner för fixar. Andra vanliga inslag är migrationsanvisningar, deprecationsinformation, samt kontaktpunkter för support och vidare dokumentation.

Processen att producera kompatibilitetsnoter sker under releaseprocessen och involverar utvecklare, testare och driftsättningsteam. Noterna bör vara versionerade och kopplade till specifika releaser, och äldre versioner arkiveras så att användare kan hänvisa till hur miljön såg ut vid tidigare versioner.

Målgruppen inkluderar utvecklare, systemintegratörer och IT-administratörer som implementerar eller underhåller produkten. Kompatibilitetsnoter fungerar tillsammans med installations- och migrationsguider och fungerar som en referens för planering, testing och riskbedömning. De har inte en garantifunktion utan beskriver snarare nuvarande stöd och kända begränsningar.