September 3, 2009

How to get help from an Open Source developer

Eric Raymond and others worked hard to produce and excellent guide on how to ask smart questions. I often give talks about QGIS or open source development in general and I usually end it with a slide or two about how to get help, in which I cover some of the same topics listed in the aforementioned article.

Unsurprisingly, I have been ‘victem’ to many of the scenarios they paint. I use ‘victem’ in a gentle sense as it’s often a source of amusement or triggering mild disinterest rather then getting my hackles up. Asking questions and asking for help is an art that many people just havent grasped. As an open source developer, our most important currency is time. Any question that wastes time is likely to have unsatisfactory outcome. Here then is my bullet list to problem resolution that will hopefully help you get a good result in trying to solve your problems.

  • Try every solution you can think of first
  • Google (and learn to use google advanced search) for a solution
  • Decide on the nature of your question – is it a general user question (how do I do xyz?) or a technical question (feature xyz should do this but does something else, how come?).
  • Post your question to an appropriate list based on the step above. Use your head and pick a list where the people most likely to be able to answer you are most active and responsive
  • Provide just enough detail to make the issue clear
  • Ask only one question at a time / in a thread
  • Dont hijack an existing thread for a new question
  • If someone offers you a suggestion, respond with the outcome of their suggestion when you tried it.
  • If you get the problem resolved, always write back to the list summarising what it was and how it was resolved
  • Always thank the person who helped you – it will make them more inclined to help you in the future
  • Sometimes people don’t know the answer to your question. If you get no answer do some more independent research, reformulate your question and try to repost it.
  • Dont take the fact that someone has tried to help you as an invitation to start an offlist conversation with them. Keeping your discourse on the list makes it searchable and the developer won’t have to answer the same thing another time for someone else.

Sometimes you just won’t get an answer to your question. Thats life, don’t take it personally – you could be asking when others are busy, occupied elsewhere having an actual real life etc. If it happens take another crack at it yourself , try and identify someone who can help you commercially, or start thinking out of the box to get it solved.

Django debugging with Chromium on Ubuntu

A common activity when building a web application is the ‘tweak code -> reload page -> view page source’ cycle. Obviously this gets a bit time consuming and boring after a while. Under Firefox you can use tools like firebug to dynamically inspect and alter the source for your web page, but it adds quite a bit of overhead to the load times of web pages.

Googles chromium (the open source, ubuntu incarnation of their Chrome web browser) is a nice addition to the browser line up on Linux. You can easily add it by dropping a couple of lines into your /etc/apt/sources.list. Visit the Ubuntu Chromium PPA for details.

One of the features I love about chromium is its view-source url prefix e.g.:


view-source:http://yourhost/somepage/?page=4

The above is displayed in the url bar of chromium when viewing the source of a page. The great part is for example above where I am working with a django paginated dataset, I can simply change the url and press enter e.g.:


view-source:http://yourhost/somepage/?page=5

When I do that the source is immediately fetched for the next page and loaded into the page source view. No need to wait for the page to render out and then switch to source view.

Chromium is great to try out and use for cross browser testing. Its very stable in my experience, but note that it has no flash support at this stage.

Stifling Innovation : Brainstorm

I was recently interviewed for an article on open access to geospatial data in the City of Johannesburg. The article has been published online now for all to enjoy…