9

It's generally conceded that at least some documentation saves people time when "onboarding" to a new project. With that said, have there ever been any rigorous studies on how helpful various kinds of documentation tend to be? I'm particularly interested in whether there are studies that compare the relative effectiveness of different kinds of documentation in terms of time that it takes to onboard new developers to the project.

migrated from techcomm.stackexchange.com Feb 20 '18 at 15:15

1

This is the only thing that I could find that is relevant for you I think:

https://dl.acm.org/citation.cfm?id=585065

I also worked at a firm that had done such a study inhouse. But on a more general scale of low effort documentation versus actual documentation.

The result of the inhouse study was that it increased the start up time for new hires drastically from one to two weeks time needed to get to a desired level of productivity to one week or less.

  • 1
    It would be useful if you could post some of the conclusions of that study here, rather than rely on a link. – Chenmunka Mar 13 '18 at 11:32
  • It is behind a paywall. – Robin Mar 13 '18 at 12:09
  • 1
    Could you summarize them? – Monica Cellio Mar 13 '18 at 21:12
  • I edited in the result of the in house research. I am not going to buy the other one to summarize it. – Robin Mar 14 '18 at 12:09

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.