blob: b8d80e06322aca00ef36b02f2c39f6205b8d8f5c [file] [log] [blame]
<!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="img5.html"><img src="left.png" border=0 alt="Précédent"></a> <a href="img7.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_AgileALMConnect2012.htm"><img src="home.png" border=0 alt="Résumé"></a> <a href="text6.html"><img src="text.png" border=0 alt="Texte"></a></center><br>
<img src="img6.png" alt="" style="float:left"/>
<p><p style="direction:ltr;">So we can see that if documentation is often discarded in Agile methods, it is because of its maintenance, which is both expensive and painful.
That is exactly why the main purpose of Intent is to provide tooling for easily keeping your doc synchronized with your technical artifacts.</p>
<p>
I don't know if you're familiar with the <a href="http://www.charlesweir.com/papers/teamwork.pdf">Ad-hoc Corrections</a> pattern defined by Charles Weir, which tries to answer
to the same problematic with a team best practice.<br/>
All the team shares a master copy of the documentation on paper.
Any time a developer makes a change on the software that deviate from design (and hence requires a documentation update),
he must write a correction in the margin of the master copy, indicating the documentation parts that have to be updated.
</p><p>
That's exactly what Intent synchronization mechanism is about : when you make a change in code that impacts the documentation,
Intent will detect that a change occurred, find out all the documentation parts related to this change and place synchronization error markers on it.
</p>
</p>
</body>
</html>