spec stuff
refactoring, spec testing, etc
updated markdown doc