document new features
add samples with possibilities