Yeah, great points. Thanks for your feedback! Better general documentation is pretty high on our list right now. To answer your immediate question: we started

Yeah, great points. Thanks for your feedback! Better general documentation is pretty high on our list right now. To answer your immediate question: we started as a Heroku add-on, so you might take a glance at our documentation there (http://docs.heroku.com/websolr http://docs.heroku.com/websolr). It's targeted at Rails applications using Sunspot, so ymmv. We're working on creating and compiling similar guides for other platforms as well. Seems like it's high time for us to do a "review my startup" post… ;)