updating docs to explain fmtStr
starting to add examples