update spec text and refactor
add navigation links