checking warnings & md
added examples & randomizations