Wed, 04 Jan 2012
What I'm REALLY thinking about when I use your bioinformatics software
If you're like me, we pretend to care about the science in bioinformatics software. But what we really do is try to find reasons not to outright loathe the software -- because, lud knows, there are usually plenty of reasons to hate it.
In no particular order, here are the top 10 things I hate about your bioinformatics software. You know who I'm talking about.
- You posted it on SourceForge (and so I can't download the damn thing using a simple URL).
- You're not using version control (and hence are not a scientist).
- You put _ in the damned file name unnecessarily (that requires a shift key on my keyboard).
- fizbam-0.9.3.tar.gz either untars into the current directory, OR a directory named 'fizbam'. Alternatively, you named it fizbam-0.9.3-2011010101010101010101010101020.tar.gz and it untars into THAT monster of a name (and my ls goes off the screen).
- You have no README, or, if you do, it's a one-liner that refers to a URL (didn't I already download your damned software?) OR 5a. Your README file is in HTML (less is better than lynx, dontcha know?)
- Running 'make' rebuilds everything from scratch every time you run it (seriously?)
- There are neither tests nor examples; or, if there are, I can't run 'em, and even if they do run, I have no idea if the results are correct.
- The output is in some weird format and/or location (wait, I have to do a find to find the last file written, and then guess as to its format?)
- The command line options are poorly labeled and described, use random abbreviations, and/or are sensitive to order (unlike every good command-line parsing library written).
- You CaMEl-CaSED your software name so that not even tab completion can figure it out (program names should be all lower-case, as Darwin intended).
---
Post your top ten and send me the URLs... :)
--titus
posted at: 21:57 | path: /jan-12 | 7 comments