Skal dokumentasjon og annet innhold på nettet være skrevet for å være så lett forståelig som mulig for mennesker, eller er det viktigere at den gir mest mulig mening for AI-boter?
Spørsmålet er ikke så søkt som det høres ut som.
En kode24-leser har tipset oss om at Microsoft nylig ga en utvikler avslag på en pull request med forslag til endringer i dokumentasjonen for WSL (Windows Subsystem for Linux). Endringene skulle gjøre dokumentasjonen enklere å forstå, blant annet med en oversiktstabell.
– Takk for bidraget, vi setter pris på at du har øye for detaljer. Vi har besluttet å beholde det slik det er. En del av avgjørelsen skyldes at stadig flere bruker AI-chat for å få veiledning, og tabeller fungerer ikke alltid så bra i den konteksten, skriver Microsofts Matt Wojciakowski i en kommentar til PR-en.
«Vi har besluttet å beholde det slik det er. En del av avgjørelsen skyldes at stadig flere bruker AI-chat for å få veiledning.»
Utviklere raste mot avgjørelsen
Avgjørelsen om å ikke godta PR-en ble ikke godt mottatt.
– Dette er uten tvil den verste responsen på en dokumentasjons-patch jeg har sett noensinne! skriver én.
En annen skriver at flere og flere bruker AI-chat fordi det blir "presset ned i halsen på dem uten at de ønsker det".
– Mindre tilgjengelig dokumentasjon er ikke måten å gjøre det på.
Noen lurer på om Microsoft har gått fra forstanden, eller om det er en forsinket aprilspøk.
– Dårlig avgjørelse. La oss beholde dokumentasjonen forvirrende for mennesker, slik at maskiner kan "parse" den bedre. Kom igjen, Microsoft, dere kan bedre enn dette.
Vil ikke ha ordsalat for AI-er
En som kommenterer stiller spørsmålstegn ved om hvorvidt det er riktig at AI ikke skjønner seg på tabeller.
– LLM-er kan håndtere markdown-tabeller uten problemer. For noen LLM-er er markdown nesten deres "naturlige språk", skriver vedkommende.
Flere ber Microsoft om å revurdere avgjørelsen, og mener den ikke bare gjør dokumentasjonen dårligere enn den kunne vært.
– Som en WSL-bruker vil jeg ha hjelpsom dokumentasjon, ikke en ordsalat ment å fordøyes av LLM-er.
«Som en WSL-bruker vil jeg ha hjelpsom dokumentasjon, ikke en ordsalat ment å fordøyes av LLM-er.»
Snudde og beklaget
Microsoft-utvikleren som først hadde forkastet PR-en gikk raskt ut og beklaget.
– Oj, tøft publikum. Det er min feil at jeg nevnte AI som en del av begrunnelsen for å ikke godta PR-en. Jeg har mye innhold å gå gjennom, og dette er bare en liten del av jobben min, skriver Wojciakowski.
Han skriver videre at han bruker mindre tid på å vurdere PR-er som ser ut til å handle om preferanser for hvordan informasjon skal presenteres, siden det ofte er subjektivt.
– Men det er tydelig at brukerfellesskapet mener dette er en god oppdatering, så jeg ser gjerne på det på nytt. Vær trygg – mennesker er alltid første prioritet for meg når det gjelder dokumentasjon! skriver Wojciakowski.
Drukner i bug-rapporter skrevet av AI: «Vi blir utbrent!»
Kort tid etterpå ble PR-en merget inn, kun med mindre endringer fra det opprinnelige forslaget.
– Dokumentasjon er først og fremst for mennesker, og folk liker ikke å spille annenfiolin angående hva AI mener om den. AI bør tilpasses for å forstå menneskevennlig språk, ikke omvendt, skriver en fornøyd utvikler – og takker for en (til slutt) god avgjørelse.
