Beta
×

Welcome to the Slashdot Beta site -- learn more here. Use the link in the footer or click here to return to the Classic version of Slashdot.

Thank you!

Before you choose to head back to the Classic look of the site, we'd appreciate it if you share your thoughts on the Beta; your feedback is what drives our ongoing development.

Beta is different and we value you taking the time to try it out. Please take a look at the changes we've made in Beta and  learn more about it. Thanks for reading, and for making the site better!

Developers may be getting 50% of their documentation from Stack Overflow

gameweld (215362) writes | about a year and a half ago

Programming 1

gameweld writes "Software companies, such as Microsoft, create documentation for millions of topics concerning its APIs, services, and software platforms. Creating this documentation comes at a considerable cost and effort. And after all this effort much documentation is rarely consulted and lacking enough examples. A new study suggests that developers are increasingly consulting Stack Overflow and crowd-sourced sites over official documentation, using it as much as 50% of time. How should official documentation be better redesigned? What are the implications of software created from unruly mashups?"
Link to Original Source

cancel ×

1 comment

Sorry! There are no comments related to the filter you selected.

First post? (1)

passionplay (607862) | about a year and a half ago | (#43076381)

There isn't enough accessible source examples that clearly demonstrate the code in the documentation normally provided. If the publishing entity provided the ability to absorb the crowd-sourced examples, the fragmentation would be less and the documentation much more readily understood. This is the policy that seems to be followed by www.php.net and it seems to be working in my opinion.
Check for New Comments
Slashdot Login

Need an Account?

Forgot your password?

Submission Text Formatting Tips

We support a small subset of HTML, namely these tags:

  • b
  • i
  • p
  • br
  • a
  • ol
  • ul
  • li
  • dl
  • dt
  • dd
  • em
  • strong
  • tt
  • blockquote
  • div
  • quote
  • ecode

"ecode" can be used for code snippets, for example:

<ecode>    while(1) { do_something(); } </ecode>