make docs match tests
document component-ness