documentation routine update