1. mySociety design tip: search box landing pages

    We use Google analytics to understand how people use, and find, our sites. This blog post is a summary of one deceptively simple way we use this information to get more people to use TheyWorkForYou, our UK parliamentary tracking website.


    "Mallard landing" (at Slimbridge) by LHG Creative Photography (CC BY-NC-ND licensed from Flickr)

    One technical term: landing pages are the pages on a website that a user first arrives on from a particular link or search result. In this case, we created explicit landing pages. That is, we made these pages solely to be the target of search results. They serve no other purpose in the structure of the site; they are like super-focussed homepages. If you’ve read the blog post about minimising clicks on the homepage you’ll see that this is a clear example of that principal in action.

    We added two specific landing pages to TheyWorkForYou — here’s one of them: http://www.theyworkforyou.com/parliament/

    This page exists for a simple reason: we know that someone who uses the word “parliament” when searching on Google is probably looking for something that TheyWorkForYou can help with. By creating the “parliament” landing page, we are able to offer a page that is more likely to serve them. Incidentally, we try to make sure that searches lead to the landing page by using Google Adwords, and encouraging the Google bots to associate the page with the keywords, and other things too — but those are not the details this tip is about. Instead, look what we’ve put on that page. You’ll see it includes a set of useful explanations about parliament (it’s very common for people not to know how their parliament works), as well as a search box.

    That search box is the same one that appears on every other page on the website, in the top right-hand corner.

    But on this landing page, we’ve changed the prominence of the search box by putting it right in front of your eyes. And we added the caption: “Search for any word or phrase – see if it’s been mentioned in Parliament”.

    Yes, there’s no technical magic here. No special code. It’s our regular search box. The difference is that on this page we know the user is thinking about parliament, and that search box does indeed search extensive records of what’s been happening in parliament. If we didn’t do this, we could leave the user to figure it out for themselves. They might of course… or they might give up. As you’ll have noticed if you’ve read the previous design tips, we don’t want users to give up, ever.

    We did it again for “Hansard”. What’s Hansard? It’s the name of the transcript of all UK parliamentary debates, published by Parliament itself. Someone who knows about Hansard might be searching for it (on Google, say) and not realise that TheyWorkForYou has the entire transcript available for search. So we added another landing page. Again, it’s the same search that’s on all the other TheyWorkForYou pages, but now — for a user who’s already identified as someone who knows that Hansard exists — it’s clear that the search will do what they expect.

  2. Alaveteli in Italy

    Romina Colman is, in her own words, a Freedom of Information activist from Buenos Aires. She did a great job of recording events at AlaveteliCon, what with blogging for Argentina’s national newspaper La Nacion, copious tweeting, and videos.

    Here, Romina speaks to Andrea Menapace from Italy, co-founder of Diritto di Sapere.

    In this short clip (1:15), Andrea explains the current situation with Freedom of Information in Italy, and what his nascent organisation hopes to achieve.

    Together with Guido Romeo (science editor at Wired Italy) I am the founder of Diritto di Sapere, a brand new organisation working on the Right to Information and Transparency in Italy. I am a lawyer by training and I have been working as a researcher and project manager in human rights and humanitarian organizations. I am currently working as a consultant for international NGOs on digital media and civil society capacity building projects.

    Find Andrea on Twitter.

  3. Sites built on mySociety’s code

    Lovely Resistors by Windell Oskay

    DIY mySociety is all about making our code – and our experience – available to people who want to build similar websites in their own countries. We thought it would be helpful to list some examples of sites already using mySociety code, so you can see the variety of different possible outcomes.

    It might seem like a simple task, but identifying sites in this way isn’t as straightforward as you might think – we don’t always know when people pick up our open source code! If we’ve missed any, please do comment below and we’ll add them.

    There are also many sites around the world which were directly, or indirectly, “inspired by” ours. In these cases, the site’s owners have written their own code from scratch. That’s a subject – and a list – for another post. For now, here are all the international sites using mySociety’s code that we know about.

    Alaveteli: our Right-to-Know Platform

    WhatDoTheyKnow.com – our original Freedom of Information site
    FYI.org.nz  – New Zealand Freedom of Information site
    Pravodaznam – Bosnia and Herzegovina Freedom of Information site
    Queremossaber.br – Brazil Freedom of Information site
    Informatazyrtare.org – Albania Freedom of Information site
    Tuderechoasaber.es – Spain Freedom of Information site
    AskTheEU – Europe Freedom of Information site

    Get the Alaveteli code here.

    FixMyStreet: our fault-reporting Platform

    FixMyStreet.com – our original fault-reporting site
    Fiksgatami – Norway FixMyStreet
    FixOurCity – Chennai FixMyStreet
    FixMyStreet.br – Brazil FixMyStreet, based on both our code and FixMyStreet.ca from Canada

    Get the FixMyStreet code here

    Parliamentary monitoring and access to elected representatives

    TheyWorkForYou – our original parliamentary monitoring site
    WriteToThem – our original ‘contact your representative’ site
    Mzalendo – Kenya parliamentary monitoring site
    Open Australia – Australia parliamentary monitoring site
    Kildare Street – Ireland parliamentary monitoring site
    Parlamany – Egypt parliamentary monitoring site
    Mejlis – Tunisia parliamentary monitoring site


    A community of people, waiting to help

    Inspired by the examples above? If you’re thinking of going ahead and building your own site, we’re here to support you with our easy-to-understand guidebooks and our friendly mailing lists. In our online communities you’ll find many of the people who built the sites listed here. There’s no-one better to ask questions, because they’ve been through the process themselves, from early conception right up to completion.

    If you are one of those people who has been through the whole process of building, launching and running a site like these (with or without our codebase), and lived to tell the tale, please shout in the comments below. And especially if you’re open to people approaching with questions. Perhaps add a note to say where you prefer to have those conversations – whether that’s via your favourite mailing lists, Twitter, email or simply in the comments to this post.


    One last thought – it’s interesting to see that our code can be used for areas as small as a single city (FixMyStreet Chennai) or as large as a confederation of states (AskTheEU.org). In short, it’s scalable! How will you use it?


    Image by Windell Oskay, used with thanks under the Creative Commons licence.

  4. Alaveteli in Serbia

    Two good reasons to use Alaveteli: it’s flexible, and there’s a supportive, worldwide community. So says Danko Nikolic from Serbia in this half-minute clip.

    Danko is one of the founders of the Zajecar Initiative (ZI). ZI has grown into a leading civil society organization working outside the capital of Belgrade. On behalf of ZI, he has developed, co-managed and managed projects funded by various donors, such as National Endowment for Democracy (NED), USA Embassy Democracy Commission, USAID, Fund for an Open Society and others.

    Zajecar Initiative is now working on the Serbian version of WriteToThem, aiming to enable the citizens of Serbia to communicate with their local representatives and MPs.


  5. Alaveteli in Brazil

    This is Daniela B. Silva from Transparência Hacker in Brazil. In this short clip, Daniela speaks about launching Queremossaber, a Freedom of Information website, into a country where the Right to Know is not yet an embedded part of civic life:

    We know that these things are not going to come from Government so easily… you have to create a culture that’s not so based on secrecy; more based on dialogue.”

    Transparência Hacker is an autonomous and decentralised community of more than 800 hackers and activists for transparency and openness in Brazil. Queremos Saber is the first Brazilian platform for access to information requests. Transparência Hacker also run the Ônibus Hacker, a bus to spread DIY culture in Brazilian localities – as well as many other projects.

  6. Alaveteli in Spain

    Here’s David Cabo from Tuderechoasaber.es. In another minute-long chat, he explains the environment in Spain, into which the Alaveteli-powered site launched.

    “No-one has done it before, so no-one knows how to start.”

    David in his own words:

    I’m vice-president of Pro Bono Publico – a Spanish association organizing the biggest Open Data hackathon in the country, AbreDatos – and creator of dondevanmisimpuestos.es, a web site for visualizing the annual budgets from Spanish public administrations, developed in collaboration with the Open Knowledge Foundation (OKFN). I worked with mySociety and Access Info Europe in the development of the EU access to information site, AsktheEU.org. I launched the transparency initiative #adoptaundiputado (Adopt an MP) to crowdsource the parsing of Spanish parliamentarians’ financial disclosure reports, and have collaborated with investigative journalists in the extraction and analysis of public records (Looting the Seas, ICIJ). I’m currently working on tuderechoasaber.es, an access to information site for Spain based on the Alaveteli software and funded by more than 150 small donors using the crowdfunding platform Goteo.

  7. Alavetelicon: community, cakes, and black boxes

    AlaveteliCon delegates

    This is a cross-post from the Alaveteli blog. It was written by Seb Bacon, who organised the recent Alaveteli conference, bringing together people from many different countries to discuss building and running Access to Information websites on the Alaveteli Platform.

    Alavetelicon 2012 has finished, the tweeting has subsided, and I think I’ve just about finished digesting the enormous conference dinner. It was a lot of fun, with a host of dedicated FOI activists and hackers who could only make it thanks to the generous funding provided by Open Society Foundation and Hivos.

    The schedule was split into streams, and had lots of non-programmed time, so I only actually saw a small part of it. There are write-ups in various languages from other participants; here are some personal observations.

    Building a movement

    The main goal of the conference was to strengthen and build the community. At the time of the conference there were 7 installations of Alaveteli worldwide, but only a small amount interaction between these groups. So far, I’ve been the only person with a clear incentive to make sure people collaborate (I’m funded to do it!) This clearly isn’t sustainable; more people need to talk directly to each other. There’s no better way of building trust and understading that meeting face-to-face.

    This certainly worked well for me. Of course, I had conversations with people about Freedom of Information and database architectures, but more importantly, I now know who has a new baby daughter, who is thinking about living in a co-housing project, and who loves British 80s electronic sensation Depeche Mode. I was really struck by what a friendly group of people this was.

    Richard Hunt, who’s leading a project to launch an Alaveteli site in the Czech Republic, had some encouraging things to say about community. In his eloquent (and very quotable) presentation, he explained his journey towards using Alaveteli. At first, he wasn’t sure about using the software. He’d talked with developers who had looked at the code, and had felt it might be better to start from scratch. So Richard contacted developers who had already deployed Alaveteli sites directly, and got lots of very useful, friendly, and encouraging responses. His conclusion was that Alaveteli isn’t just a technical platform; “it is also about people — their dreams and ambitions of impeccable merit”.

    For so long it was just a dream and idle talk on our side. Now we are nearly there, and we are part of a BIG movement. Feels great, doesn’t it?

    This is encouraging, but the conversations started at the conference must continue if they are to bear fruit in the form of more international collaboration. Please join the new Alaveteli Users mailing list, and share ideas or ask questions there!

    The future of Alaveteli

    There was a lot of discussion of which new features should be added to Alaveteli next, some of which I’ve listed on the alaveteli-dev Google group. However, three general themes particularly struck a cord with me:

    1. More collaboration, less confrontation
    In the UK, we have been accused of encouraging a confrontational, points-scoring approach to FOI. At the conference, there were stories of how FOI actually frees people within a bureaucracy to speak directly to the requester — without having to go via a press office. We heard of various cases where ministries actively wanted to take part in Alaveteli pilots. In the UK, we have found that FOI officers take their jobs very seriously, and do want to work with the Alaveteli concept; yet they feel that sometimes it makes things unnecessarily hard for them.

    I’m not sure what conclusion to take from this, exactly. It remains the case that Alaveteli must be able to deal with obstinate authorities that don’t want to play the game, and it is a prime virtue of the system that it remains well outside the bureaucracies that it aims to hold to account. However, I’m left with a sense that we should examine how we can continue to do this while providing more support to our allies within the System.

    2. Cake and fireworks
    Lots of people at the conference asked for more statistics to be made available on Alaveteli sites. mySociety has always been a little reluctant to release statistics, because they are so easy to spin or misinterpret. However, delegates repeatedly referred to their power for campaigning. The psychological impact of a big red cross next to your organisation’s name, which you can remedy through positive action, is a powerful motivator. One idea that was mooted was to award a real-life prize (a.k.a. Cake and Fireworks) to the “top” authorities in various categories each year. I think this is a great idea.

    3. Black Box APIs
    Acesso Inteligente is an FOI website in Chile that doesn’t use Alaveteli. In Chile, all FOI requests must be made via various different web forms. Accesso Inteligente is a tremendous technical achievement which automatically posts requests to the correct organisation’s form, and “screen scrapes” the results, giving Chilean citizens a uniform interface to make all FOI requests.

    The team behind the website would love to use Alaveteli as their front end system. The concept they’ve come up with is deceptively simple: repackage their form-posting-and-scraping functionality as a “black box” which acts as if it’s an authority that accepts FOI requests by emails, and sends the answers by email. They can then install Alaveteli without any modifications, and configure it to send FOI requests to the relevant “black box” email addresses.

    I love this concept for its simplicity, and I think it can easily be extended to support other use cases. For example, there’s a lot of talk of an Alaveteli system that supports paper requests and responses. This might best be implemented as a “black box” that receives and sends email, with an implementation that helps a human operator with printing and scanning tasks in the back office.

  8. Tuderechoasaber.es


    A Right-to-Know site for Spain

    Tuderechoasaber.es is Spain’s brand new Right-to-Know site, built on Alaveteli. The project is managed by David Cabo and Victoria Anderica, and it launches against a fascinating political background.

    When the project was started, Spain was one of four EU countries with no Freedom of Information law. The subject was, however, on the political agenda – FOI had been promised, but not delivered, by the previous government in both 2004 and 2008. On election in December 2011, the new conservative ruling party again pledged to introduce Freedom of Information, within their first 100 days in office.

    Anderica works at the organisation Access Info Europe, which had been campaigning, with the support of NGOs including Amnesty International and Greenpeace, for a Freedom of Information law. Cabo is one of the founders of Civio, a new organisation hoping to emulate the work of mySociety or the Sunlight Foundation, in Spain. The combination of Access Info and Civio’s knowledge – legal and technical – meant that Tuderechoasaber.es could become a reality.

    There was such public thirst for these withheld rights that Cabo and Anderica were able to fund their website through crowdsourced donations. They raised €6,000 and the site was built.

    Tuderechoasaber (“Your Right to Know”) launched on the 22nd of March 2012, just a day before the Government opened a public consultation on Freedom of Information (just inside that 100-day deadline). Their promise has now been fulfilled and Spain finally has its Right-to-Know law.

    Meanwhile, Tuderechoasaber welcomed more than 11,000 visitors during the first two days it was live. 180 requests were sent – never mind that they slightly preceded the Freedom of Information law actually coming into existence.

    Practicalities of launching a Right to Know site

    Launching a site like Tuderechoasaber might seem an impressive task, and undoubtedly, much work has gone into it – and will continue to do so.

    But it may be more achievable than you think. We asked David a few questions, and here are his thoughts on the matter:

    How long did the Alaveteli installation/site build take?

    It didn’t take long at all. I was familiar with Alaveteli, as I had developed AsktheEU.org already, so the whole technical work was done over a couple of weeks by myself, while campaigning and coordinating other stuff.

    Setting up the server took a couple of days max, and I spent a few more days redesigning the front page and a few other things: we want/need to give the site a more dynamic look, including regular news and encouraging people to support other users’ requests. Most people in Spain don’t know what FOI is or how it’s used, and that includes the public servants, so we need to be more aggressive to get responses.

    How simple or otherwise did you find it? What were the major hurdles (from a development point of view) that you had to overcome?

    Easy. Development-wise there were no big issues; we’ve uncovered a few caching bugs, but that’s about it.

    Adding the blog posts and pictures on the frontpage is a bit of a hack right now, but no big deal. 90% of our time has been talking to media and public bodies, before and after the crowdfunding. Oh, and coordinating the translations and volunteers.

    How much time is the day-to-day running of the site taking at the moment, and how much time do you anticipate spending, after the initial publicity dies down?

    Too early to know how it will look once it’s settled. It’s a week now since launch, and although the media focus has moved a bit away from FOI (there was a general strike today about job market reform) we’re now getting 2K users a day. So far we have 270 requests, which is way more than we expected.

    There’re 8000 city councils in Spain, plus the regional and national bodies, so the day-to-day work now – which is taking two people a few hours a day – is finding more contact details. We expect to have a couple of part-time volunteers handling support, and two part-time journalists writing about what happens on the site.

    Could anyone take the plunge and run a site like this, or are there certain qualities you think it’s necessary to have?

    Legal understanding of the FOI situation in their country seems essential to me. We couldn’t have built this without Access Info. Apart from that, I don’t think the technical or operations requirements are too complex. Of course, being active in civil society and/or having a community of interested users definitely helps to get the site moving.

    Would you mind being contacted by others considering building an Alaveteli site?

    Sure, that’s fine, happy to talk about it by email or Twitter. [If you’d like to take David up on this generous offer, find him in the first instance on Twitter at @dcabo.]

    What is Alaveteli?

    Alaveteli is one of our Platforms. Install it, and you can create a Freedom of Information website like WhatDoTheyKnow.com, which we run in the UK.

    Alaveteli websites work like this:

    • Users can contact public authorities with requests for information.
    • The sites publish those requests, and the resulting responses.
    • Or if there is no response, they make that fact known.

    No right to Freedom of Information? Launch anyway

    The right to Freedom of Information varies from jurisdiction to jurisdiction: in many countries it is enshrined by law. In others, there is no such law.

    In both scenarios, we encourage people to set up Alaveteli sites.

    Why? Because one of the core tenets of running an Alaveteli site is that we believe it should reflect how the law should work, not how it does.

    As an example, our site WhatDoTheyKnow.com allows users to contact several bodies which are not actually subject to the UK’s Freedom of Information Act – and many of them do reply to requests made through the site.

    Additionally, when we launched the site, there was no prior example of putting responses to Freedom of Information requests into the public domain. Because we believe in the benefits of transparency, we went ahead and did so anyway.

    WhatDoTheyKnow was launched in the context of the UK having a Freedom of Information law, but there is nothing to stop you from launching a site even where such a law does not exist.

    Find out more about Tuderechoasaber

    Find out more about Alaveteli