Updates to readmes
FX-282
FX-283
Updated github readme
Further updates to readme
Added TOC