kth.sePublications
Change search
CiteExportLink to record
Permanent link

Direct link
Cite
Citation style
  • apa
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • Other style
More styles
Language
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Other locale
More languages
Output format
  • html
  • text
  • asciidoc
  • rtf
Designing to Optimise Usability of API Documentation Interfaces: Applying a User-Centric Approach to Enhance Developer Experience
KTH, School of Electrical Engineering and Computer Science (EECS).
2024 (English)Independent thesis Advanced level (degree of Master (Two Years)), 20 credits / 30 HE creditsStudent thesisAlternative title
Designa för att optimera användbarheten av API-dokumentationsgränssnitt : Tillämpning av ett användarcentrerat tillvägagångssätt för att förbättra användarupplevelsen hos utvecklare (Swedish)
Abstract [en]

An application programming interface (API) allows different software applications to communicate and interact with each other. The API is accompanied by documentation, which contains information about what the API does and how to use it. For an API to be useful and attractive to developers, it is important that the documentation is comprehensive, organised and accessible. If not, the API runs the risk of being abandoned. Research has shown that good API documentation facilitates good API usability, therefore, the design and content of the documentation should not be dismissed.

This study takes a user-centred approach to investigate the user experience of API documentation among developers. Nine developers participated in the study. By exploring how software developers use documentation, it aims to identify key areas for improvement and develop strategies to improve the overall usability of documentation. Important elements that enhance user experience are highlighted. These elements included, among others, a search function, version manager, and a display of resource status. This research provides insights into the design of software documentation and how to design with a user-centred approach. This approach shows how user-centred design methods can be very useful in discovering user requirements and meeting user needs in product development processes.

Abstract [sv]

Ett applikationsprogrammeringsgränssnitt (API) gör det möjligt för olika mjukvaruapplikationer att kommunicera och interagera med varandra. Med API:et medföljer dokumentation som innehåller information om vad API:et gör och hur det används. För att ett API ska vara användbart och attraktivt för utvecklare är det viktigt att dokumentationen är omfattande, organiserad och enkel att använda, annars riskerar API:et att överges. Forskning har visat att bra API-dokumentation ökar API:ets användbarhet och därför bör man inte bortse från dokumentationens design och innehåll.

Denna studie använder en användarcentrerad metod för att undersöka utvecklares användarupplevelse av API-dokumentation. Nio utvecklare deltog i studien. Genom att undersöka hur utvecklare använder dokumentation syftar studien på att identifiera förbättringsområden och utveckla strategier för att förbättra användbarheten. Specifika element som bidrar till en förbättrad användarupplevelse betonas. Dessa element inkluderade bland annat en sökfunktion, versionshanterare och en visning av resursstatus. Denna forskning ger insikter i designen av mjukvarudokumentation och hur man utformar den genom ett användarcentrerat tillvägagångssätt. Studien visar hur användarcentrerade designmetoder kan vara mycket användbara för att upptäcka användarkrav och tillgodose användarnas behov i produktutvecklingsprocesser.

Place, publisher, year, edition, pages
Stockholm: KTH Royal Institute of Technology , 2024. , p. 23
Series
TRITA-EECS-EX ; 2024:433
Keywords [en]
API, API documentation, user experience, user-centred design
Keywords [sv]
API, API dokumentation, användarupplevelse, användarcentrerad design
National Category
Computer Sciences Computer and Information Sciences
Identifiers
URN: urn:nbn:se:kth:diva-351278OAI: oai:DiVA.org:kth-351278DiVA, id: diva2:1886980
Presentation
2024-06-05, 15:00 (English)
Supervisors
Examiners
Available from: 2024-09-19 Created: 2024-08-05 Last updated: 2025-02-18Bibliographically approved

Open Access in DiVA

fulltext(561 kB)125 downloads
File information
File name FULLTEXT01.pdfFile size 561 kBChecksum SHA-512
96d497701760b8b831f3536525c23b6aeb8fe76bae7f7e5f4dc29a2394ac4daaf1b74354eb0fe4418b9ea0d9fda37dc6ea113a6e771c8178ee25e74035bac44b
Type fulltextMimetype application/pdf

Search in DiVA

By author/editor
Jansson, Frida
By organisation
School of Electrical Engineering and Computer Science (EECS)
Computer SciencesComputer and Information Sciences

Search outside of DiVA

GoogleGoogle Scholar
Total: 125 downloads
The number of downloads is the sum of all downloads of full texts. It may include eg previous versions that are now no longer available

urn-nbn

Altmetric score

urn-nbn
Total: 184 hits
CiteExportLink to record
Permanent link

Direct link
Cite
Citation style
  • apa
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • Other style
More styles
Language
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Other locale
More languages
Output format
  • html
  • text
  • asciidoc
  • rtf