<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Jan 9, 2014 at 6:43 AM, Antoine Musso <span dir="ltr"><<a href="mailto:hashar+wmf@free.fr" target="_blank">hashar+wmf@free.fr</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">Le 02/01/14 17:37, Nikolas Everett wrote:<br>
><br>
> Elasticsearch doesn't use its test as documentation at all.  They<br>
> instead force developers who submit pull requests to always write the<br>
> feature, the tests, and the documentation all in the same pull request.<br>
> I like this method because it keeps you honest.  If the tests can build<br>
> some or all of the documentation then that is better.<br>
<br>
</div>I like that workflow a lot.  For MediaWiki core unfortunately, most of<br>
the doc is on some wikis and we barely have any unit tests :-(<br>
<span class="HOEnZb"></span></blockquote><div><br></div><div>Cirrus keeps its documentation in the README and we're OK at keeping it up to date.  I figured there was no chance I'd keep the <a href="http://mw.org">mw.org</a> page up to date.  This did remind me to update the <a href="http://mw.org">mw.org</a> page to actually tell people that which is nice.<br>

<br>Nik<br></div></div></div></div>