update docu; add value readers to models