we can also document like this.

the above code uses an observer, when the search term in the input box changes, the observer is fired. the getJSON request is wrapped in a debounce(that shouldn't be 2 seconds, but whatever for now) -- after the user stops typing for 2 seconds, then the ajax request is made. It returns a promise which is given to the self.set('aProperty', data.location) line above. I just used data.location b/c it was easily accessible. 

what we really want to do is use the array provided by the autocomplete api to populate a dropdown box with jquery. the first result in the array should show up as 'autocomplete' like functionality (similar to google search)... when the user presses tab, the first result should be chosen and the full request should be make

this requires we expose the autocomplete api proxy at its own route

documenting stuff is hard