better sample docs