refactoring, doc
linear search
addressed some comments. fixes
x