tests green. added links to docs and to ease demo