yard 0.8.7.4 complains about these as undocumented

So let's document them
Similarly `@api private` had no effect here so lets make them private