adds examples of the source files on the readme, and removes unused reference to an optional field