fix: formatting
add: revised section on family of specs
add: intro text and additional sections