specs + examples
readme merged