improve ref-specs doc