document CAS ID management issue and some other details