After writing about a thousand lines of documentation, I'm spent. I'd like to write something witty or clever or fun, but I got nothing.
With some Optaros blessing I released a Django Solr module out into the wild. It was written by Jay Dolan for a top 20 newspaper site about 9 months ago, but had to be rewritten for Django 1.0 and I got side tracked with clients and Alfresco.
Google tells me that about 4 people a day search for "django solr". So good news I just made 4 people's day. My ego boo is out of this world right now.
On a less bitter note the project is pretty damn cool. You set up a few search documents and all of a sudden you have all your models searchable, facetable and highlighted. Dare I call it... magic.
Lessons Learned
-
Write documentation. It will quickly inform you where your code sucks.
-
It's really hard to justify to friends that going home and coding something you are going to give away is better than drinking.
-
Sphinx documentation is the best.
-
"Hey, we should open source that." I've often heard the sweet words fluttering softly around the office. I now know why it's never done. Simply because it's a lot more than writing a good piece of code. Making it easy to use and telling people how to use it is a lot harder.
In future posts I'll talk about how to use it. For now read the documentation.
Thank you! Sounds great, I'll try use it in my projects asap! (i'm one of "the four" someday months ago...)