should have docs in yard format

## motivation

Removes legacy rdoc format and marks many method private.