<br><br><div class="gmail_quote">2011/2/20 Gregory Pittman <span dir="ltr"><<a href="mailto:gpittman@iglou.com">gpittman@iglou.com</a>></span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
One hopes that it can progress in tandem with the code, by necessity a bit behind cutting-edge features</blockquote><div><br>Actually, shouldn't that be the way around? Documenting is thinking. We can look at this from two ends. Case #1 The program exists and it is (partially) or (not well) documented, hence the necessity to explain afterwards — and this comes naturally, yes, behind. Case #2 We can think of a more integrated way of doing things where any idea or feature or enhancement that makes it into the application is first well-thought of, defined, described, thus truly documented before it is actually coded.<br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">, and like code should have a modular structure, ideally documentation should have a structure that allows for easy multipurposing and reuse of materials.</blockquote>
<div><br>There is obviously no need to rewrite everything when a new version of the application is released. And if there is, then this means that it is not an update but a rewrite of the application or a total change in the way it behaves.<br>
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">I don't think we are there yet, but I would like to see us move in that direction. Already we have been a more active participant in documentation updates and "bugfixes" coming with svn code updates and bugfixes<br>
</blockquote><div><br>Which is good and which also proves the “doc first code next” approach to be efficient. <br><br>Louis<br></div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br>
Greg.<div><div></div><div class="h5"><br>
_______________________________________________<br>
CREATE mailing list<br>
<a href="mailto:CREATE@lists.freedesktop.org" target="_blank">CREATE@lists.freedesktop.org</a><br>
<a href="http://lists.freedesktop.org/mailman/listinfo/create" target="_blank">http://lists.freedesktop.org/mailman/listinfo/create</a><br>
</div></div></blockquote></div><br><br>