docs for catalog: Alex’s review comments