reformatted document and added examples