improve registry documentation