docs: refresh code references after repository maintenance
docs: document issue 28 README redesign and validation