| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/transitional.dtd"> |
| <html> |
| <head> |
| <meta HTTP-EQUIV=CONTENT-TYPE CONTENT="text/html; charset=utf-8"> |
| <title>Create Useful Documentation with Mylyn Intent : transcript</title> |
| <link rel="stylesheet" type="text/css" href="talk.css"> |
| </head> |
| <body text="#000000" bgcolor="#FFFFFF" link="#000080" vlink="#0000CC" alink="#000080"> |
| <center> |
| <a href="img0.html"><img src="first.png" border=0 alt="Première page"></a> <a href="img3.html"><img src="left.png" border=0 alt="Précédent"></a> <a href="img5.html"><img src="right.png" border=0 alt="Suivant"></a> <a href="img29.html"><img src="last.png" border=0 alt="Dernière page"></a> <a href="Intent_ece2011.htm"><img src="home.png" border=0 alt="Résumé"></a> <a href="text4.html"><img src="text.png" border=0 alt="Texte"></a></center><br> |
| <img src="img4.png" alt="" style="float:left"/> |
| |
| <p><p style="direction:ltr;">But enough with theoretical talk : developers do need high-level doc, and it's not me who says it, but the developers themselves !</p> |
| <p style="direction:ltr;"></p> |
| <p style="direction:ltr;">In a recent survey performed on a very large number of people, from open-source and Proprietary softwares, developers were asked what kind of doc they would want to use, and what kind of doc they actually use in their day-to-day work.</p> |
| <p style="direction:ltr;"></p> |
| <p style="direction:ltr;">The results are stunning : let me just quote the conclusion of this study. |
| Althoug developpers a getting of lot of detailed information of the code (through Javadoc mostly), they are <b>lacking the high-level overviews</b> on softwares and architecture |
| that would realy help them to understand the software.</p> |
| <p style="direction:ltr;"></p> |
| <p style="direction:ltr;">But one can ask, if high-level doc is wanted that much, why does no one write it ? Or why does everyone write it so bad ? </p> |
| <p style="direction:ltr;"></p> |
| <p style="direction:ltr;"></p> |
| |
| </p> |
| </body> |
| </html> |
