progress on docs (links and forms, response interpretation)