<div dir="ltr">Hi,<br><div class="gmail_extra"><br><div class="gmail_quote">2017-03-07 5:58 GMT+01:00 Nyall Dawson <span dir="ltr"><<a href="mailto:nyall.dawson@gmail.com" target="_blank">nyall.dawson@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
<br>
I think a better solution is to hook into the current<br>
[FEATURE]/[NEEDS-DOCS] hooks which auto-open issues on the<br>
documentation repo. We could *require* that all developers who push a<br>
new feature commit have to post on the corresponding documentation<br>
auto-opened issue with at least very rough notes about how the feature<br>
is supposed to work. The documentation team could then polish these<br>
up, add screenshots, etc (and merge when the timing is right for the<br>
team). This would also keep things as easy as possible for devs so<br>
that they (*cough*... i mean me *cough*) have no excuse not to do it!<br>
<span class="HOEnZb"><font color="#888888"><br></font></span></blockquote><div>You are right, Nyall. <br>However, I do not think that they later need to add information in the auto-opened issue in Doc repository. By default the generated issue is populated with all the information in the commit. So a really descriptive commit to QGIS repository with those tags should be enough. There are some very good (from a doc writer pov of course) commits where you only need to find the right place in the doc and copy paste the description with minor adjustments. Unfortunately, they are currently far from being the majority. On the other side, there still are many with simply the title (which sometimes can be helpful) or do use a dev language (too much cryptic?).<br><br></div><div>Also note that a verbose commit benefits to the Changelog team, when time comes....<br><br></div><div>Harrissou<br><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="HOEnZb"><font color="#888888">
Nyall<br>
</font></span></blockquote></div><br></div></div>