updated readme with workflow notes and moved specs to the docs folder