<p dir="ltr">I have thought about that for tool tips and documentation (not code), and I think it sounds better in the descriptive form. I guess for code this is similar. </p>
<br><div class="gmail_quote"><div dir="ltr">A seg, 14/08/2017, 09:40, Nyall Dawson <<a href="mailto:nyall.dawson@gmail.com">nyall.dawson@gmail.com</a>> escreveu:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 14 August 2017 at 18:23, Matthias Kuhn <<a href="mailto:matthias@opengis.ch" target="_blank">matthias@opengis.ch</a>> wrote:<br>
> Hi devs,<br>
><br>
> I have just realized that we never decided on a very important question,<br>
> so I thought it would be a good point in time to do this now.<br>
><br>
> Should documentation for methods be written in imperative or descriptive<br>
> language? In explicit, should it be<br>
><br>
> * "Add a new part to a multi type geometry"<br>
><br>
> or<br>
><br>
> * "Adds a new part to a multi type geometry"<br>
><br>
><br>
> I have a tendency for imperative "Add a new part...".<br>
<br>
I'd go the other way, and use "adds a new part"/"returns the outline<br>
color"/etc. Reason is that this is what Qt does, which we've modeled<br>
other parts of our standards on.<br>
<br>
Nyall<br>
_______________________________________________<br>
QGIS-Developer mailing list<br>
<a href="mailto:QGIS-Developer@lists.osgeo.org" target="_blank">QGIS-Developer@lists.osgeo.org</a><br>
List info: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a><br>
Unsubscribe: <a href="https://lists.osgeo.org/mailman/listinfo/qgis-developer" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-developer</a></blockquote></div><div dir="ltr">-- <br></div><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Alexandre Neto</div><div>---------------------</div><div>@AlexNetoGeo</div><div><a href="http://sigsemgrilhetas.wordpress.com">http://sigsemgrilhetas.wordpress.com</a></div><a href="http://gisunchained.wordpress.com">http://gisunchained.wordpress.com</a><br></div></div>