Added `rake docs` using YARD. [ci skip]
Correct a few small YARD doc syntax errors. [ci skip]
Marked a number of interfaces as @api private. [ci skip]