add examples for reads and variants, small fixes for common and references