update docs; add CI badge

- update documentation to reflect changes made.  Old documentation kept as well, since it still works.  (Listed as "legacy")