updated some docs, added example, added some comments to frame