better documentation samples