Against conventional wisdom, we’ve just published the staff manual for FixMyStreet Pro online, where it’s easy for anyone to access.
When we were putting this manual together, we thought we’d have a quick google round for other council SAAS documentation, to see if anyone was doing it particularly well.
We didn’t get very far, though — it seems there’s a culture of corporate secrecy amongst other suppliers, and a fear of publishing such materials in case of imitation.
Why so open?
We’ve gone our own way on this one for a few reasons.
First, because it helps our clients. We know that it’s far easier for customers to look online for materials than it is to remember where they’ve put a physical handbook.
We know we could have put it behind a password, but that just adds an impediment for our existing customers, as well as for anyone hoping to understand the service a little better before making a purchasing decision. Plus, who remembers passwords for something they might only be accessing a couple of times a year? It’s just extra faff.
This way, staff only need bookmark the documentation page, and they’ll always be able to find the most up to date version of the manual.
There’s another reason as well, though. Most mySociety codebases — including FixMyStreet — are Open Source, meaning that anyone who wants to can inspect or use the code for their own purposes. If anyone really wanted to know our ‘secrets’… well, they’re already out in the public domain.
We reckon there’s more to gain by publishing our instruction manual than there is to lose. Sure, competitors might see what features we offer, and they might even copy them. We’re confident, though, that our customer service, company culture, and our insistence on making our products as user friendly as possible, all give us an advantage that imitators are unlikely to be able to match.
So, if you’re from a council yourself (or if you’re just curious) please do go ahead and read the manual. We hope you’ll find it of interest, and that it might cast some light on what makes FixMyStreet Pro different from other offerings in the field.
One of the projects we’ve been working on at mySociety recently is that of making it easier for people to set up new versions of our sites in other countries. Something we’ve heard again and again is that for many people, setting up new web applications is a frustrating process, and that they would appreciate anything that would make it easier.
You can use these AMIs to create a running version of one of these sites on an Amazon EC2 instance with just a couple of clicks. If you haven’t used Amazon Web Services before, then you can get a Micro instance free for a year to try this out. (We have previously published an AMI for Alaveteli, which helped many people to get started with setting up their own Freedom of Information sites.)
Each AMI is created from an install script designed to be used on a clean installation of Debian squeeze or Ubuntu precise, so if you have a new server hosted elsewhere, you can use that script to similarly create a default installation of the site without being dependent on Amazon:
In addition, we’ve launched new sites with documentation for FixMyStreet and MapIt, which will tell you how to customize those sites and import data if you’ve created a running instance using one of the above methods.
These documentation sites also have improved instructions for completely manual installations of either site, for people who are comfortable with setting up PostgreSQL, Apache / nginx, PostGIS, etc.
We hope that these changes make it easier than ever before to reuse our code, and set up new sites that help people fix things that matter to them.
Photo credit: duncan