changes, requirements updates and switch to RST formatting