improve Common documentation
use markdown in yard