<div dir="ltr"><div class="gmail_default" style="font-size:small">Hi,</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">I would like to ask for your feedback to improve the documentation of QgsProject.clearProperties (<a href="http://qgis.org/api//classQgsProject.html#ae23318aec80be782d330ce36097b2e5d">http://qgis.org/api//classQgsProject.html#ae23318aec80be782d330ce36097b2e5d</a>). I'm afraid the current wording is dangerously confusing. Only one of the last lines gets to the point that it "<span style="color:rgb(0,0,0);font-family:Roboto,sans-serif;font-size:14px;line-height:22px">removes all project properties".</span></div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Imho, that should be the first line. And add a fat exclamation mark too. Currently it reads like the function is totally harmless and only clears some plugin properties:</div><div class="gmail_default" style="font-size:small"><p style="font-stretch:normal;font-size:14px;line-height:22px;font-family:Roboto,sans-serif;color:rgb(0,0,0)">syntactic sugar for property lists</p><p style="font-stretch:normal;font-size:14px;line-height:22px;font-family:Roboto,sans-serif;color:rgb(0,0,0)">extra properties, typically added by plug-ins</p><p style="font-stretch:normal;font-size:14px;line-height:22px;font-family:Roboto,sans-serif;color:rgb(0,0,0)">This allows for extra properties to be associated with projects. Think of it as a registry bound to a project.</p><p style="font-stretch:normal;font-size:14px;line-height:22px;font-family:Roboto,sans-serif;color:rgb(0,0,0)">Properties are arbitrary values keyed by a name and associated with a scope. The scope would presumably refer to your plug-in. E.g., "openmodeller".</p></div><div class="gmail_default" style="font-size:small">... It somehow reads like these lines don't actually belong to this method but are ment to describe something else. </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Would love to hear your thoughts on this.</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Thanks and best wishes,</div><div class="gmail_default" style="font-size:small">Anita</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style><br></div></div>