Document usage of captions for tables and figures

Relates to #236 (closed)