readme update including some specs