<div dir="ltr">On 14 January 2014 00:44, Manuel Quiñones <span dir="ltr"><<a href="mailto:manuq@laptop.org" target="_blank">manuq@laptop.org</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
> We just need a way to know what is public API and what is not. Maybe, for<br><div class="im">
> new code, everything is public unless it has the usual underscore or there<br>
> are inline docs mentioning it's not public. For old code well... I guess we<br>
> just decide case by case.<br>
<br>
</div>Yes, I think that's valid for old code too.  If you can import a<br>
class, function or constant variable from the toolkit, its public.<br>
</blockquote><div><br></div><div>Trying to make sure we are on the same page here, the devil is in details on this kind of stuff :)<br><br></div><div>* I think stuff prefix with _ is private, even if you can import it.<br>
</div><div>* I think it should be possible to mark stuff private by documentation. Maybe we should use a PRIVATE "keyword" so that it's more human and machine greppable. That's because sometimes you have modules that are only used internally, but you don't want to put _ everywhere.<br>
</div><div>* I'm OK to consider existing code which doesn't follow the two rules above as public. It means that if we want to clean up we will probably have to deprecate some stuff, but it's fine if it keeps the policy simpler.<br>
</div><div><br>
</div></div></div></div>