(#290) Add spec tests and clean up github comments