<p>In <a href="https://github.com/mlpack/mlpack/pull/664#discussion_r67889562">src/mlpack/core/tree/rectangle_tree/no_auxiliary_information.hpp</a>:</p>
<pre style='color:#555'>> +
> +namespace mlpack {
> +namespace tree {
> +
> +template<typename TreeType>
> +class NoAuxiliaryInformation
> +{
> + public:
> + NoAuxiliaryInformation() { };
> + NoAuxiliaryInformation(const TreeType* ) { };
> + NoAuxiliaryInformation(const TreeType& ) { };
> +
> + /**
> + * Some tree types require to save some properties at the insertion process.
> + * This method should return false if it does not handle the process.
> + */
</pre>
<p>I spent a while reading through <code>NoAuxiliaryInformation</code> and <code>HilbertRTreeAuxiliaryInformation</code> and it took me a long time to understand exactly what <code>HandlePointInsertion</code>, <code>HandleNodeInsertion</code>, <code>HandlePointDeletion</code>, and <code>HandleNodeRemoval</code> did (like what the parameters were, what the return value should be).</p>
<p>To me it seems like each of these methods allow the auxiliary information the option of manipulating the tree to perform the insertion/deletion itself, but if the auxiliary information does that, then it should return true; if false is returned, the RectangleTree performs its default behavior.</p>
<p>Do you think you could add some documentation to both this file and HilbertRTreeAuxiliaryInformation detailing this? (and what the HilbertRTreeAuxiliaryInformation does?) That way someone else who wants to add some different auxiliary information class in the future (or just wants to understand these) will have a much easier time.</p>
<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/mlpack/mlpack/pull/664/files/f9127cea62d5ce1ad8d5f59931de108a2f7cdd9b#r67889562">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe/AJ4bFAk96G7MqzokWTLNF3O6InndjEEwks5qOAFLgaJpZM4IrlzT">mute the thread</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/AJ4bFFtUU7uwtmjzaOlLl56uJCtVtCOQks5qOAFLgaJpZM4IrlzT.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://github.com/mlpack/mlpack/pull/664/files/f9127cea62d5ce1ad8d5f59931de108a2f7cdd9b#r67889562"></link>
<meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>