revise doc text to have good catalog text primer