mboost-dp1

Stack Overflow

Undersøgelse: Udviklere får op imod 50 % af deres dokumentation fra crowd documentation

- Via ninlabs research - , redigeret af Pernicious

En undersøgelse foretaget af Chris Parnin på 17 forskellige Android-udviklere viser, at programmører i høj grad er gået væk fra at benytte officielle dokumentationshjemmesider, når de skal finde informationer om en API, de skal bruge.

I stedet er udviklere begyndt selv indirekte at dokumentere API’erne, blandt andet på blogs og gennem spørgsmål og svar. Særligt hjemmesiden Stack Overflow bliver brugt, hvor man kan bede andre programmører om hjælp, eller finde andres spørgsmål, hvis de har samme problem som en selv. Parnin har tidligere vist, at en flok af Android-udviklere kan dække 88 % af Androids API’er bare ved at diskutere dem iblandt hinanden på Stack Overflow.

Undersøgelsen fulgte i alt de 17 udviklere i 1.316 dage, hvilket giver et gennemsnit på 11 uger per udvikler, og i denne periode blev Stack Overflow besøgt 9.234 gange, mens den officielle dokumentation af Android blev besøgt 2.547 gange.

Op imod 50 % af den dokumentation som udviklere bruger, får de fra Stack Overflow. Nogle udviklere får endda deres viden ved at følge udvalgte brugere på Stack Overflow: Ved at læse disse brugeres mange indlæg, danner de sig en grundviden, der gør dem i stand til at forstå den officielle dokumentation.

Især efter websøgninger er det ofte resultatet, at udvikleren besøger Stack overflow. Det er hele 2-10 gange mere sandsynligt, end at udvikleren besøger den officielle dokumentation. Det er specielt fordi, at Stack Overflow indeholder dobbelt så mange eksempler på kode, som den officielle dokumentation gør.





Gå til bund
Gravatar #1 - Virtual-Aidz
6. mar. 2013 11:50
17 udviklere ud af....99999 tusind udviklere? (overdrivelse fremmer forståelse)


Hvis man spørger 10 udviklere om hvad deres ynglings platform er og de siger "Jeg kan godt li' android!", så er det vel ikke ensbetydende med at alle udviklere elsker android, eller har jeg fejlet statistik regning i skolen? :P
Gravatar #2 - luuuuu
6. mar. 2013 12:17
Udviklere er sjovt nok også de it folk der er allerdårligst til at skrive ordentlig dokumentation. De har ingen forståelse for, at andre mennesker ikke allerede har indsamlet flere års erfaring med det givne produkt.

Desuden er det sjældent, især på store projekter, at den enkelte udvikler har noget som helst overblik over andet en hvad hans dims kan, og hvordan den er bygget.

"Hvordan den spiller sammen med resten af programmet? Who knows and who cares? Dig? Nå, men det var da ærgerligt. Spørg på internettet. Jeg har travlt med at kode på et nyt projekt."
Gravatar #3 - Flexo82
6. mar. 2013 14:28
#2 Det har vel også noget at gøre med at man ofte er tidspresset i projekter og så bliver dokumentationen sidestillet da kunden betaler for et produkt der kører, og ikke en stak papirer der beskriver hvordan produktet skulle have kørt
Gravatar #4 - Hubert
6. mar. 2013 14:40
Flexo82 (3) skrev:
#2 Det har vel også noget at gøre med at man ofte er tidspresset i projekter og så bliver dokumentationen sidestillet da kunden betaler for et produkt der kører, og ikke en stak papirer der beskriver hvordan produktet skulle have kørt


Nu er jeg ikke udvikler men jeg ville da mene at dokumentationen en en del af produktet.
Gravatar #5 - arne_v
6. mar. 2013 15:46
#0

Skræmmende.

Den officielle dokumentation beskriver hvordan produktet bør virke. Hvis produktet virker anderledes, så er det en fejl, som skal rettes.

Tilfældig dokumentation på internettet kan være rigtig eller kan være forkert alt afhængig af om forfatteren ved noget eller ej.
Gravatar #6 - arne_v
6. mar. 2013 15:49
#1

Der er ret stor usikkerhed ved så lille en stikprøve og risikoen for skævhed i udvælgelsen er stor.
Gravatar #7 - johan
6. mar. 2013 18:06
Det er vel fordi SO bliver besøgt oftere og har flere links, at de ranker højt på Google, og dermed bliver der klikket på dem
Gravatar #8 - Magten
6. mar. 2013 18:41
Det kan vel også være et udtryk for at de mener dokumentationen er for dårlig/mangelfuld?

Hvis jeg er stødt ind i dårlig dokumentation for et produkt flere gange så begynder jeg da også at kigge alternative steder.

Men jeg er så ikke udvikler ^_^
Gravatar #9 - Herter
6. mar. 2013 19:41
Den officielle dokumentation indeholder så langt fra altid specifik implementation af et givent problem. Det gør SO og andre forums tilgengæld.

Den officielle dokumentation indeholder typisk forklaring på API osv som også er nyttigt, men typisk er det en løsning på et specifikt problem som udviklere googler efter. Det gør jeg hvertfald selv.

Det er godt nok sjældent jeg besøger Java's egen dokumentation, men SO er jeg inde på dagligt.

Det bedste SO osv. kan tilbyde er eksempler og forklaring for mere erfarne og dygtigere udviklere.. igen noget dokumentation typisk ikke kan levere.

Og hvis folk forventer bedre dokumentation af ny software skal der ikke snakkes med udvikleren, men derimod IT-chefen eller som minimum personen der sidder på penge posen. Der er bare ikke penge i det i alle it-firmaer og derfor bliver det ofte nedprioriteret meget. Simpel Javadoc giver lidt, men det der oftest er brug for er forretningsviden og det dokumentation bliver sjældent beskrevet godt nok da der simpelthen ikke er penge til det.
Gravatar #10 - mrtb
6. mar. 2013 19:54
Tror du har fat i noget #9.

Selv hvis den officielle dokumentation er 100% i orden, så vil man stadig kunne komme ud for at man har brug for at kombinere nogle funktioner for at opnå noget bestemt.
Det er i netop sådan nogle tilfælde at sider som SO er yderst nyttige, da der er tilstrækkelig nok andre folk der sidder og laver det samme, til at der stort set altid er en der har haft det samme problem før.
Gravatar #11 - Skak2000
6. mar. 2013 20:09
Jeg er blevet meget glad for Stack Overflow.
Stack Overflow har fået sin egen Google søge knap i min browser...

Jeg finder det nemmere at forstå kode/eksempler fra Stack Overflow end officiel dokumentation. Hver person har sin egen lærringstil.

Jeg ved dog at Stack Overflow, bliver brugt dagligt af samtlige elever på min skole. (Datamatiker udd)

[url= most schools don't teach [/url]
Gravatar #12 - arne_v
7. mar. 2013 14:02
Herter (9) skrev:
Den officielle dokumentation indeholder så langt fra altid specifik implementation af et givent problem. Det gør SO og andre forums tilgengæld.


Herter (9) skrev:
Den officielle dokumentation indeholder typisk forklaring på API osv som også er nyttigt, men typisk er det en løsning på et specifikt problem som udviklere googler efter. Det gør jeg hvertfald selv.


mrtb (10) skrev:
Selv hvis den officielle dokumentation er 100% i orden, så vil man stadig kunne komme ud for at man har brug for at kombinere nogle funktioner for at opnå noget bestemt.


Ja. Men nu skrives der jo.


En undersøgelse ... viser, at programmører i høj grad er gået væk fra at benytte officielle dokumentationshjemmesider, når de skal finde informationer om en API, de skal bruge.



Creating this documentation comes at a considerable cost and effort. And after all this effort much documentation is rarely consulted...



Instead, developers have been indirectly documenting APIs themselves through a process called crowd documentation, by publishing blog posts and curating questions and answers about APIs.


Hvilket jeg ihvertfald læser som at man erstatter officiel dokumentation omkring specifikke API kald med Google og SO - ikke at man supplere den med information omkring hvordan man bruger det til at løse et problem med via Google og SO.

Gravatar #13 - arne_v
7. mar. 2013 14:02
Skak2000 (11) skrev:
Jeg finder det nemmere at forstå kode/eksempler fra Stack Overflow end officiel dokumentation.


Sikkert.

Men nem garanterer ikke god.
Gå til top

Opret dig som bruger i dag

Det er gratis, og du binder dig ikke til noget.

Når du er oprettet som bruger, får du adgang til en lang række af sidens andre muligheder, såsom at udforme siden efter eget ønske og deltage i diskussionerne.

Opret Bruger Login