add trimming example
refactor docs