improving error reporting on failure requesting valuation
rename
updated HTMLs in line with the book