1. Better-looking emails for FixMyStreet

    If you’ve used FixMyStreet recently — either to make a report, or as a member of a council who receives the reports — you might have noticed that the site’s automated emails are looking a lot more swish.

    Where previously those emails were plain text, we’ve now upgraded to HTML, with all the design possibilities that this implies.

    It’s all part of the improvements ushered in by FixMyStreet Version 2.0, which we listed, in full, in our recent blog post. If you’d like a little more technical detail about some of the thought and solutions that went into this switch to HTML, Matthew has obliged with in a blog post over on FixMyStreet.org.

  2. I created a template for writing to an MP, and then I deleted it

    Twitter comment

    We were glad to see this tweet back in July, when @adebradley identified WriteToThem as the place to go for information on how to write to your MP. We do try to make that process as easy as possible, so it was a fair assumption that we’d have such a template1.

    But in fact, it was also a mistaken assumption, although we do have some more general advice in our FAQs. Basically, we offer lots of help on how to use our service, but we assume that the user can manage perfectly well once they’ve got to the ‘compose’ screen.

    So I did what I always do when a user points out a ‘nice to have’ feature for one of our sites: I ticketed it on Github, our issue-tracking system. And then, when I got round to it, I sat down and did some thinking, and read some other websites which offer advice on writing to your MP.

    And then I created a template to show people how to compose a letter that would be clear, readable, and likely to get a result.

    But…

    As I was doing so, something felt wrong.

    Firstly: who was going to visit this template? Even if we linked to it from the FAQs, would anyone ever find it? We know (without having to check our analytics, merely from the kind of messages we often get in our support mail) that the FAQs are not universally read. They’re more widely read since we moved the ‘Help’ link to the top right of every page, but all the same, it seems many users would rather drop us a line than find the answer on an FAQs page.

    Then secondly: my template began to feel very patronising. Here was I, someone whose job is copywriting, handing out tips to… well, who? Presumably, our more educated, literate, eloquent users were not staring at a blank screen wondering how to begin a message to their MPs.

    No: the people who need help writing to their MPs are going to be people who find it hard to express themselves in writing, and probably have never contacted their representatives before. And they are also the people least likely to wade through my sanctimonious examples and admonishments about what kind of language to use.

    So, what now?

    I took the issue to my colleagues, who were very helpful in sorting through this thinking. One of them led me to this link, which underscored the uneasiness over whether anyone ever reads FAQs, with wisdom like:

    FAQs are convenient for writers […] But they’re more work for readers.

    And between us, we reached the conclusion that the problem of people not knowing what, or how, to write to an MP wasn’t going to be solved by copywriting after all: if it was going to be solved at all, it was going to be with design and development.

    If we were really going to help our users, it’d have to be right there on the page, at the moment when they get stuck.

    Just as FixMyStreet gives discreet tips about what kind of content is appropriate in a report, WriteToThem might also guide a user to start with a clear statement about what the writer wants or needs, and to follow up with concise details. Or it might detect bad language and alert the user that their message is likely to disappear into an MPs’ anti-abuse filter. Maybe we could have an optional template within the ‘compose’ box which could be toggled on or off.

    We haven’t got any further than that yet, and we promise not to build the 21st century equivalent of Clippy — but what started with a tweet may end up as some in-browser guidelines.

    Meanwhile, if you’re looking for some help writing to your MP, here are our under-visited FAQs, and here’s an excellent guide to writing to your MP from Open Rights Group.

    Footnote

    1 It’s probably worth clarifying that, when we talk about templates for letters to MPs, we are not talking about the sending of identikit messages – rather, we mean guides as to what sort of content to include. We have always, and will always, encourage users to write in their own words, and block mass messages from those who don’t. Here’s why.


    Image: Grant Hutchinson (cc by-nc-nd/2.0)

  3. The small symbol that tells you all is well

    When you send a Freedom of Information request, a clock starts ticking. Here in the UK, public authorities are bound by law to answer a request “promptly, and in any case within 20 working days” — but of course they can only respond if they’ve received the request.

    And, while email is generally reliable, we’re all familiar with the occasional mishaps it can bring: mailboxes that are full, accounts that have been closed down, or messages being returned because they look too much like spam.

    As Liz’s post yesterday mentioned, our Freedom of Information platform Alaveteli now includes a new feature which verifies that your message actually has been delivered.

    Sign here please

    Email works a bit like signed-for physical mail. When a letter is delivered to a recipient they either sign to say they’ve received the letter, or the mail company records that there was no-one available to accept the delivery. This lets the mail company keep the sender up to date with where their letter is. Mail servers do the same — the recipient server sends a confirmation that a particular email has been received, or an error code is reported by your mail server if there’s a problem delivering the email.

    Like physical mail, we can only verify that the message has been accepted at the destination address. It’s then under the recipient’s control to get it to the right person at that address, a bit like a receptionist receiving a letter for an employee 10 floors above. We think that if an authority’s mail server confirms that one of our emails has been delivered, it’s their responsibility to ensure it reaches the correct people to be able to answer your FOI request.

    Proof of receipt

    Look at the header of any request on WhatDoTheyKnow, and within 24 hours, in most cases you’ll now see a small green ‘delivered’ confirmation:

    Example of the green 'verified' tick on WhatDoTheyKnow

     

    Most users can click on this to see further confirmation:

    Your request has been delivered - example from whatDoTheyKnow

    But if you’re the owner of the request, when you click on the green ‘delivered’ link, you’ll see information from the mail logs as the message passed through our server. If there’s ever a query about whether or not a message was delivered, you can hand these on to the authority to help them analyse any issues.

    Exmple of a user's view of the mailpath on WhatDoTheyKnow

    On the rare occasions that something goes wrong, here’s what users will see instead:

    What requesters see when something goes wrong on WhatDoTheyKnow

    – and if it’s your own request, again, you’ll have access to the mail logs.

    Small but mighty

    This feature might look small, but there’s a lot of thinking behind it — just check the length of the trail on Github, our ticketing system. Anyone will be able to understand the amount of discussion and problem-solving that went into the addition of this small green tick, while the more technically-minded may also find it interesting to see the coding solutions as they unfolded.

    This small green tick also gives users something rather powerful: proof that their request was received by the authority’s mail server at a specific time, should that be disputed.

    The suggestion for this feature came initially from one of the WhatDoTheyKnow volunteers. It took some time to implement, but we’re pleased to say that it has now been made available for all Alaveteli sites in release 0.25.0.0.


    Image: Pacific Northwest Agricultural Safety and Health Center (CC)