Monthly Archives: July 2010

Digigov Draft Guidance on Commentable Documents

So it seems that the COI are taking comments on some draft guidance for commentable documents: TG134 Commentable documents – [draft guidance] (via Steph Gray/@lesteph, who first brought the idea of commentable consultation documents to my attention through his work at DIUS).

Getting on for 18 months or so ago, Joss Winn and I set up WriteToReply as a platform for experimenting with ideas around the republication of public documents in a commentable form on WordPress using the CommentPress theme. As you will know if you have visited WriteToReply, these theme atomises documents so that each paragraph has a separate URL, and each paragraph can be independently commented on. Since then, we have helped support the development of the WordPress theme, now versioned as and as maintained by Eddie Tejeda, and introduced the idea to JISC via the JISCPress Rapid Innovation project. is also being used at De Montfort University to help amplify the outcomes of workshops and meetings as part of an internal project development process (Meeting/Workshop Amplification at DMU).

Although independently maintained (we set up Public Platforms Ltd, a not-for-profit company, limited by guarantee, to manage its interests), several government departments (DCMS, Cabinet Office) have approached us with requests to republish consultation documents or guidance for them, which we have been happy to do. We have also hosted essays and reports from a range of other organisations (for example, Cornerhouse, and UKOLN) and seen a range of JISC funded reports starting to appear on As a platform, WriteToReply has also been able to host republications of public documents on behalf of individuals who have felt that particular documents needed to be made available in form where they could be easily discussed online. We have also taken it onto ourselves to republish documents that we felt should be made available in a commentable form, or that we believed would provide a good case study for how commentable documents in general, and the atomisable, commentable documents that we can republish using in particular, might be used to widen a discussion around a particular topic; (so for example, we have explored publishing committee related papers from the Public Sector Transparency Board).

Through republishing these documents, we have started to get a feel for some of the things that make a commentable document easier to publish and navigate.

With the COI looking to produce guidance on commentable documents as a way of “giv[ing] people the opportunity to comment publicly online about ideas, proposals and plans”, I’d like to think we’ve played a contributory role, through WriteToReply, in developing ideas around how commentable documents can play a a role in document based public consultation and policy development and will be able to continue to contribute to this approach.

As for my thoughts on the draft guidance, which covers engendering trust, managing commentable documents and technical considerations? I’ll probably be posting those on the TG134 Commentable documents – [draft guidance] website directly 😉

PS see also another draft guidance note – TG135 Underlying data publication [draft guidance] on the publication of data by government departments and agencies.

Meeting/Workshop Amplification at DMU

How many times have you been to a meeting or a workshop within your institution where group discussions result in flip charts and posters that are used as part of a “reporting back” activity, and then are taken away at the end of the day for who knows what reason?


Way back when, in a real-time computing course I think, I was introduced to the notion of an “atomic transaction”. As Wikipedia succinctly puts it: “atomicity: a property of database transactions which are guaranteed to either completely occur, or have no effects.” Now I’m not saying that meetings completely occur and have no effects, but many of them do seem to be atomic in that what happens in the meeting stays in the meeting, to paraphrase another well known saying…

In a handful of recent posts, I’ve started thinking about how we can soften the boundaries of meetings so that they can become part of a wider – and ongoing – “conversation”, rather than being activities that are located in a very specific time and place (e.g. Amplified Meetings and Participatory Deliberation…, Using WriteToReply to Publish Committee Papers and Backchannel Side Effects – Personal Meeting Notes).

That is, there are now weveral ways where we can widen the availability of papers and discussions both in terms of time (extending the period of time over which participants can draw on and contribute back to meeting resources) and reach (i.e. making it possible for me people to contribute).

Examples of how we might do this include:

– annotating documents using commenting platforms such as WriteToReply and JISCPress;
– capturing backchannel comments and interlacing them with meeting reports or using them as video or audio captions.

Anyway, earlier today I spotted a great example of the use of a commenting platform to extend the life of a workshop via a tweet from @josswinn pointing to a new site at DMU – First meeting.

Commentable documents at DMU

This document summarises the outcomes from discussions in the first DUALL engagement meeting on July 1st 2010 and offers a set of recommendations for the design of an ICT reporting tool. It is not detailed set of minutes but rather aims to present the broad overview of discussion. The full presentation from the meeting is available below. There was an extremely good representation from both the IESD and the Faculty of Technology. For the group discussion it was decided to break into two groups, based on departmental basis so as to allow for discussion on the detailed requirement of each area to be sub-metered.

This document has been published so that you can comment on the outcome of the meeting in detail. Each paragraph can be directly responded to and threaded discussions can occur around each paragraph. To leave a comment, simply click on the speech bubble next to the paragraph.

A few things to note:

– the document is published using the theme on a local installation of WordPress at DMU;
– the document is published on the public web – although it could equally have been published behind the DMU authentication layer (i.e. “on the intranet”);
– the documents are viewable by, and commentable on, by anyone (I think? But I think it’s also the case that comments could be limited to people who log on the blog, e.g. using DMU credentials or single sign-on… so I think that comments could be restricted to DMU folk if required?)
– this opening up of discussion particularly around the IT area should be heartwarming for Brian Kelly at least, who’s been trying to get institutional web managers to share via web team blogs (e.g. Revisiting Web Team Blogs); maybe they should also be sharing policy discussions…?!
– exploring the use of new ICT systems to discuss ICT is a Good Thing and an Appropriate Thing. For example, on WriteToReply, the Cabinet Office have been keen to publish several of their documents (e.g. Government ICT Strategy, Government Open Source Action Plan).

If any other institutions have started exploring the use of the theme and the WriteToReply approach to document publishing, please add a link below 🙂

Document/Comment Interlacing with

Via a tweet from Joss earlier today, I came across this post on How to read David Willetts’ speech to the Royal Institution in which William Cullerne Brown interlaces his own comments (shown in red) at the appropriate points within the speech transcript:

Annotated speech

I’ve recently been experimenting with various “single page” commentable documents – such as speeches – in my doodlings area of WriteToReply (most recently posting VInce Cable’s “Higher Education” speech in a commentable form), so when I saw the above approach it got me wondering: could we use WriteToReply to achieve a similar effect?

The them already provides:

– a paragraph level RSS feed out from a particular web page, where each feed item carries the URL of the original paragraph;

– a feed of comments an individual commenter (commentator?) has made across all the posts on a particular blog, where each feed item contains a guid that refers to the paragraph that was being commented on.

So, whilst I don’t have time at the moment to post a working demo, it should be able to combine these two feeds to provide an inline commented view of a document, such as the one shown above, that represent a version of the (single page) doc with inline annotations from a single commentator.

This approach could also be used to provide an “expert commentary” around a document, e.g. in an educational setting?

OPML Support for JISCPress and WriteToReply

What’s the easiest way to read a document published on JISCPress or WriteToReply? One answer is just to read the document on the parent site, but another way is to pull the content into another space using the RSS/Atom syndication feeds that WordPress makes available, and that the plugin opens up even further.

In what follows, I’ll use URLs for example docs published on both JISCPress:

The simplest subscription option is just to subscribe to the document as an RSS feed:

This will pull the whole document into your feedreader, with each section of the document (i.e. each “page” of the doc as published on JISCPress/WriteToReply) as it’s own “blog post”.

Note that this form of subscription displays the posts in reverse order – to view the sections that make up the document in the “proper” order, we use URLs of the form:

To view the comments from the document as a whole, we need a URL that looks like:

It is also possible to get a separate RSS feed out of the platform for each page, as well as a separate comment feed for each page. For example, single item RSS feeds, where each page has an RSS feed with one item in it – the content of that page:

And for comment feeds on a page basis:

If you were viewing any of these sorts of feed in a feed reader such as Google Reader, you would be able to favourite and share each separate page or each separate comment, for example.

For an example of the sort of thing this makes possible, see An Example Netvibes Dashboard for the Digital Britain Interim Report on WriteToReply.

We can also get feeds out on a page basis where each paragraph has a separate feed item to itself:

If you were viewing these sorts of feed in a feed reader such as Google Reader, you would be able to favourite and share each separate paragraph.

With so many separate feed URLs available, it can be a problem entering them separately into a dashboard such as Netvibes or a feed reader such as Google Reader, so I’ve created a couple of OPML generators:

They both take similar sorts of parameters, which are a little opaque at the moment as I try to work out sensible OPML element configurations.

The first parameter we need for the generator specifies the document:

Then we have the parameters b, c, s, and p… If you set these parameters in the URL (e.g. b=1, c=1&s=1), they act as follows:

$c = (isset($_GET[‘c’])) ? true : false;
// import feeds corresponding to comment feeds at the page level (i.e. each page will have its own comment feed or tab in the reader/dashboard)

$s = (isset($_GET[‘s’])) ? true : false;
// import feeds corresponding to single feed item per page feeds (i.e. each page will have its own feed or tab in the reader/dashboard; a single feed item will represent the whole of the page contents)

$p = (isset($_GET[‘p’])) ? true : false;
// import paragraph level feeds at the page level (i.e. each page will have its own feed or tab in the reader/dashboard and each paragraph will be a separate feed item)

if ((!($c))&&(!($p))) $s=true;
//default behaviour – if no comments and no para level feeds, use single item page level content feeds

$b = (isset($_GET[‘b’])) ? true : false;
// bundled – one folder – all the feeds will be imported into a single folder/page
// the default should be true, but it isn’t, so you’d be advised to normally set this parameter…

Using these various parameters, you can create a range of OPML files that can be used for the bulk import of feeds from a document published on WriteToReply or JISCPress. (Typically, you will need to donwload a copy of the OPML file to your desktop and then upload it to your dashboard/feed reader application. Download the document using File->Save Page As (and then choose the simplest format possible… e.g. Web Page, XML only).)

So for example:

These OPML feeds can be useful for:

– importing feeds into Netvibes in one go, and creating dashboards with either one tab per document, or separate tabs for each document;

– importing feeds into Google Reader, so that you can read, share and favourite parts of documents (even down to the paragraph level if you import paragraph level feeds).

[Note: I’m thinking that the generation of paragraph level feeds needs tweaking in so that the title shows the first 50 or so characters of the paragraph, rather than the page title?]

Using WriteToReply to Publish Committee Papers. Is an Active Role for WTR in Meetings Also Possible?

Last night I spent an hour or two putting the various papers released so far by the Public Sector Transparency Board on WriteToReply, an unofficial act but one that seems to have met with approval:

WTR public Secotr Transparency Board

The majority of documents we’ve published on WriteToReply previously tend to be large, standalone documents, albeit with multiple sections that we tend to map on to separate blog posts. Recently, I’ve also started exploring how it feels to post “single page” consultations within a more general blog setting (e.g. Single Page Commentable Consultation Docs).

The PSTB site is a different matter, however, because there are likely to be several separate documents for each meeting of the board (if nothing else, at least and agenda and the minutes), as well as multiple sittings of the board.

Public Sector Transparency Board, WTR

So how does this change things?

The first thing to realise is that the structure – one post per document – encourages linking between documents. So for example, if the agenda identifies that a particular document was a subject of discussion, a link can be included to that page. If a particular section, or point raised in a document is minuted, then the way that WriteToReply generates unique URLs for each paragraph means that a link can be included that references that particular paragraph.

Capturing the forward path – from document paragraph in to the minutes, for example – relies on WordPress capturing a link from the minutes to a paragraph link via a trackback. It strikes me that in a WTR environment, if notes or minutes on the discussion of a particular paragraph or section were captured as comments, then a comment feed would automatically capture an ordered and referenced set of notes/minutes, that could be fed directly into a derived document?

The ability to syndicate and embed (i.e. transclude) paragraph level content from one WriteToReply document in another web document (as demonstrated in Engaging With the Issues Raised By The Google Book Settlement and described in Taking the Conversation Elsewhere – Embedded Quotes) is also a feature that begins to look attractive once we start thinking about a document ecosystem. So for example, if we minute a reference to a particular document in a tabled document, we might allow the viewer to read that paragaph via a sub-text annotation within the context of the minutes.

A more extreme mechanic might to be allow the reader to view elements of documents considered by the Board using a TiddlyWiki like mechanic; (if you haven’t tried TiddlyWiki, follow the link to it now, and then try clicking on some of the links on the TiddlyWIki page. For some users, the TiddlyWiki user experience is compelling; others hate it…)

In this case, clicking on a link in a minute would dynamically pull in the corresponding paragraph or section from the linked to document. Once read, the user could then “close” the referred to paragraph. (You really do need to have played with TiddyWiki recently to appreciate what I might mean by that!)

To return to the PSTB example, it will be interesting to see how the evolving nature of the site plays out and whether WriteToReply could play an active role in both the preparation for and run up to a meeting, as well as recording discussions and decisions made by the Board.

For example, if we manage to get prior notice of tabled items and the meeting agenda, then we’ll be able to solicit comments on very specific items that can possibly be referred to within the meetings of the Board itself. Even Board members might use WTR to take notes on – and solicit further comments on – particular sections of the document, as well as being able to refer to them via user feeds during the meeting itself.

As we get more documents, we should be able to increase the linkage between documents (though it will remain to be seen how that might turn out to be useful, if at all). In the sense that the published documents (and comments) provide a corpus for a search engine over issues considered by the Board, I think we’d probably need to offer paragraph level search, as well as comment level search (e.g. see this demonstration hack: Paragraph Level Search Results on WordPress Using and Yahoo Pipes; I don’t think it searches comments though? In fact, does WordPress allow users to search through comments?).

I believe that there is certainly scope for using this sort of approach to “amplify” both preparation for and dissemination of PSTB discussions at the very least. If anyone else out there would like to explore the possibility of using a WriteToReply environment to support meeting based activities (“amplified meetings”), (either on a public site or a closed site), please get in touch:-)

Single Page Commentable Consultation Docs

With a new doc out on WriteToReply published by DCMS, I’ve started getting fired up again by the sorts of things that I think the platform is capable of, so over the next couple of weeks I hope to post a few ideas, and will then start looking for ways of trying to get the ones that seem workable and useful actually implemented (and ideally, funded).

So for example, one of the things I’ve been playing with are what we might refer to as “single page consultations” (micro-consultations?). Here are a couple of examples:

Here’s another example:

Lessons Learned from Publishing Local Election Data

Note that this isn’t a consultation, as such, more it’s a set of observations (lessons) that might benefit from discussion, or that independently (at paragraph level) might act as a useful focus of, or foil for, further discussion.

So – my observation, based on the examples above, is that there may be some mileage in exploring a WriteToReply-like way of publishing short, single page documents that would benefit from being able to offer:

– unique paragraph level URLs (atomisation);
– commenting at the paragraph level (commentability), with the ability to track comments associated with a particular paragraph.

Of course, it’s easy enough to add unique URLs within any document yourself using the the name attribute within and HTML <a>/anchor element.

So for example, <a name=”here”>here</a> can be linked to by appending #here to end of the current page URL.

However, the approach I’m thinking of would be more automated than that. For example, a WordPress theme (style sheet) or plugin extension that would:

– allow the user to place a chunk of text to be atomised and made commentable in a particular HTML block element (such as a blockquote, or a div with a particular class attribute) and then do the thing to the content in that block element; this could presumably be achieved by tweaking to only run over a limited set of block elements; for page load efficiency, any necessary client-side code would only be loaded if an appropriate block element was present in the page; or

– allow the user to place a chunk of text to be atomised and made commentable within a WordPress shortcode block (e.g. using the WordPress shortcode API, and then let the shortcode API mark up and include any necessary client side code within the block; or

– allow the user to create a custom blog post type that applies the theme to that post.

To make the single commentable pages work in within the context of a blog with non-commentable posts and an arbitrary visual theme, the commenting mechanic for “embedded” or “inline” atomisable and commentable areas may need to change from the floating comment panel used as a default by for an inline theme (see for example Inline Comments on WriteToReply? or this example of “sub-text annotations”: New Buzzwords: Geo-Aware eBooks and Sub-text Annotations).

I’m not sure whether any of the above strategies would work, but the sort of capability I’m after is some sort of WordPress plugin that would let me run an everyday blog, but then for certain posts, or a subset of the content of certain posts, have it atomised and made commentable. So for example, I could include a list of recommendations, or questions, or references, within a blog post, and automatically let the theme give just those elements unique URLs and make them separately commentable.

PS following a tweet from @girlinthe regarding the availability of a comments feed from a particular page, I added a simple sidebar link to just such a thing.

Page level comments feed on WTR

It’s configured simply by adding a link to: feed, which is a link relative to the current page URL. That is:

Comments for this page on WTR

When the link is displayed, the current page URL is prepended, so the link actually points to

Remember, you can also get a variety of other feeds out from the page too.

For example, the full text of the page can be grabbed as a single item RSS feed from the URL:

An RSS feed of the page containing each paragraph as a separate feed item can be obtained using the construction:

Don’t you just love WordPress, and the theme?!;-)

Signaling Important Document Paragraphs in WriteToReply – And a Possible Mobile Theme?

One of the strategies I use for reading long documents that I want to comment on take detailed notes from is to read through the document quickly, marking or highlighting the parts I think are important (or quotable), and then doing another pass where I dwell on the parts I marked.

With the publication via WriteToReply of a comment soliciting speech from Ed Vaizey on public libraries yesterday (Remodelling Libraries, [press release]), I started thinking again how we might support a highlighting approach in WriteToReply. In a post earlier this year ( – Like, But With Ratings Rather than Comments?), I briefly considered how we might publish documents in a paragraph atomising way (as we do using the WordPress theme) and then allow readers to add ratings (rather than comments) to the document at a paragraph level. Something like this, maybe:

favouriting paragraphs

Another factor that I think needs to be taken into account is the ability to read documents on mobile devices. A variety of mobile themes are available for WordPress, from the “run anywhere WordPress mobile edition to the iPhone/Android loving WPTouch.

So what I’ve started thinking is that maybe should be a mobile theme to complement a desktop browser theme along the lines of and the mooted, that would allow users to “favourite” or “star” paragraphs they think are important so they can return to them later, maybe on a desktop or portable computer, rather than a mobile device (hmm… desktop, portable, mobile…). For exampe, the should:

0) work on mobile devices;
1) atomise docs into paragraphs;
2) allow a user to “favorite” a paragraph;
3) allow a user to review a list of the paragraph they have favourited;
4) allow a user to optionally comment on the paragraphs they have favourited;
5) allow a user to look at the paragraphs favourited by another user;
6) allow a user to look at a list of the most favourited paragraphs across all users.

(Note that similar functionality (1+) should also be made available on the parent website via a parent theme.)

The aim of doing this is to identify quickly, and without the need to comment, those paragraphs that are deemed “important”. (I did wonder whether the “favouriting” should offer two options – “important”, and “needs challenging”?)

Unlike the 5 star ranking scheme sketched in the image above, we’d only need a single star:

More doodlings around the idea of

It might also be worth considering indicating how many other people had favourited a paragraph? For example:

ALternative views of favoriting with count

In the above example, the star/count appears at the end of the paragraph, because you ant to signal the importance of the paragraph after you have read it…

ALternatively, we might try to signal the perceived importance of the paragraph at the start of the paragraph, and then allow to the reader to make their own signal after reading it:

Your signals and my signal - doodle

The aim of the idea is to provide a way for readers to flag those sections of a document that are worthy or requiring of comment, and thus be capable of acting as a precursor to commenting on those sections. For mobile users, where time may be tight, the keyboard interface fiddly or difficult to use, the simple interaction – click to star – means that users can read a document and bookmark those parts of it that are important to them.

The ability to view the document via a filter of “most heavily favourited” provides a crowd sourced alternative to an executive summary of the document.

PS I am using the star as a way of signaling the importance of particular paragraphs. It’s not hard to extend this idea to social signaling, where for example a user clicks to tweet the link to that particular paragraph, or clicks to share the link to that paragraph on a social bookmarking service such as delicious.