Stöd programutvecklare

Det lönar sig att hantera driftsättningsprocessen för programmeringsgränssnittet på ett kundorienterat sätt. Ur ett företagsekonomiskt perspektiv är detta förknippat med kundens värdekedja (Customer Value Chain), som beskriver processen från identifiering av behov till driftsättning.

På utvecklarupplevelsen inverkar

• beslut som tagits i planeringsskedet
• stödet under användningen.

Nedan listas egenskaperna hos ett väl genomfört programmeringsgränssnitt som optimerar dess effektivitet, användbarhet och långa livscykel.

Programmeringsgränssnitten är ofta svåra att använda, vilket leder till att programutvecklarna lägger ner mycket tid på att lära sig dem.

Felaktig användning kan orsaka felsituationer och informationssäkerhetsproblem.

Enligt en undersökning (Thayer et al. 2021. A Theory of Robus API Knowledge. ACM Transactions on Computing Education.Öppnas i ett nytt fönster.) behöver utvecklarna tre slags information om programmeringsgränssnitten:

1. Branschinformation: Programmeringsgränssnittet beskriver branschen och använder dess begrepp. Tydlig dokumentation förbättrar användbarheten.
2. Användningsmodeller: Hur programmeringsgränssnittet används och varför olika användningssätt är motiverade.
3. Funktionsbeskrivning: Hur programmeringsgränssnittet fungerar (flöden och utskrifter) och hur det är integrerat i applikationen.

God dokumentation består av flera lager. Den ger snabbt information om programmeringsgränssnittets funktion och användningssituationer samt exempel (frågor och svar). Även en omfattande dokumentation kan sammanfattas på webbsidan.

Programmeringsgränssnitten utvecklas för att användas och det är av största vikt att dokumentera programmeringsgränssnitt som publiceras externt. Termerna som används inom organisationen kan vara främmande för utomstående. Observera att affärsverksamhets- och programutvecklare med olika informationsbehov söker information om programmeringsgränssnitten.

Det lönar sig att stöda driftsättningen av programmeringsgränssnittet på olika sätt.

God användbarhet skapas av följande:

• lätt att lära sig
• lätt att minnas
• effektiv användning
• få fel
• bekväm.

Utvecklarupplevelsen kan också granskas utifrån stödet under programmeringsgränssnittets livscykel:

1. Att hitta programmeringsgränssnittet
2. Att förstå programmeringsgränssnittet (vad det gör, hur det fungerar)
3. Driftsättning
4. Stöd under användningen
5. Avslutande av användningen.

Till utvecklarupplevelsen hör olika verktyg och anvisningar och det är viktigt att be utvecklarna om feedback på vilka av dessa som hjälper dem i deras arbete.

Även analyser av användningen av programmeringsgränssnittet kan ge värdefull information om hur det utnyttjas.