Wordyard

Hand-forged posts since 2002

Scott Rosenberg

  • About
  • Greatest hits

Archives

Wordyard / Media / Change is good, but show your work: Here’s a WordPress revisions plugin

Change is good, but show your work: Here’s a WordPress revisions plugin

August 3, 2010 by Scott Rosenberg 27 Comments

A couple of weeks ago I posted a manifesto. I said Web publishers should let themselves change published articles and posts whenever they need to — and make each superseded version accessible to readers, the way Wikipedians and software developers do.

This one simple addition to the content-management arsenal, known as versioning, would allow us to use the Web as the flexible medium it ought to be, without worrying about confusing or deceiving readers.

Why not adopt [versioning] for every story we publish? Let readers see the older versions of stories. Let them see the diffs. Toss no text down the memory hole, and trigger no Orwell alarms.

Then I asked for help creating a WordPress plugin so I could show people what I was talking about. Now, thanks to some great work by Scott Carpenter, we have it. It’s working on this blog. (You can get it here.) Just go to the single-page form of any post here (the one that’s at its permalink URL, where you can see the comments), and if the post has been revised in any way since I published it, you can click back and see the earlier versions. You can also see the differences — diffs — highlighted, so you don’t have to hunt for them.

The less than two weeks since my post have given us several examples of problems that this “show your work” approach would solve. One of them can be found in the story of this New York Times error report over at MediaBugs.

An anonymous bug filer noticed that the Times seemed to have changed a statistic in the online version of a front-page story about where California’s African Americans stood on pot legalization. As first published, the story said blacks made up “only” or “about 6 percent” of the state population; soon after it was posted, the number changed to “less than 10 percent.” There’s a full explanation of what happened over at MediaBugs; apparently, the reporter got additional information after the story went live, and it was conflicting information, so reporter and editor together decided to alter the story to reflect the new information.

There is nothing wrong with this. In fact, it’s good — the story isn’t etched in stone, and if it can be improved, hooray. The only problem is the poor confused reader, who saw a story that read one way before and now reads another way. The problem isn’t the change; it’s the failure to note it. Showing versions would solve that.

Another Times issue arose yesterday when the paper changed a headline on a published story. The original version of a piece about Tumblr, the blogging service, was headlined “Facebook and Twitter’s new rival.” Some observers felt this headline was hype. (Tumblr is successful but in a very different league from the vastness of Facebook and Twitter.) At some point the headline was rewritten to read “Media Companies Try Getting Social With Tumblr.” Though the article does sport a correction now fixing some other errors, it makes no note of the headline change.

I don’t know what official Times policy is on headline substitution. Certainly, Web publications often modify headlines, and online headlines often differ from print headlines. Still, any time there’s an issue about the substance of a headline, and the headline is changed, a responsible news organization should be forthright about noting the change. Versioning would let editors tinker with headlines all they want.

I do not mean to single out the Times, which is one of the most scrupulous newsrooms around when it comes to corrections. Practices are in a state of flux today. News organizations don’t want to append elaborate correction notices each time they make a small adjustment to a story. And if we expect them to, we rob ourselves of the chance to have them continuously improve their stories.

The versioning solution takes care of all of this. It frees writers and editors to keep making their work better, without seeming to be pulling a fast one on their readers. It’s a simple, concrete way to get beyond the old print-borne notion of news stories as immutable text. It moves us one decent-sized step toward the possibilities the Web opens up for “continuing stories,” iterative news, and open-ended journalism.

How the plugin happened: I got some initial help from Stephen Paul Weber, who responded to my initial request to modify the existing “post revision display” plugin so as to only list revisions made since publication. Weber modified the plugin for me soon thereafter (thank you!). Unfortunately, I failed to realize that that plugin, created by D’Arcy Norman, only provided access to version texts to site administrators, not regular site visitors.

Scott Carpenter, the developer who’d originally pointed out the existing plugin to me, stepped up to the plate, helped me work up a short set of requirements for the plugin I wanted, and set to work to create it. Here’s his full post on the subject, along with the download link for the plugin. We went back and forth a few times. He thought of some issues I hadn’t — and took care of them. I kept adding new little requirements and he knocked them off one by one. I think we both view the end-product as still “experimentally usable” rather than a polished product, but it’s working pretty well for me here.

As the author of a whole book on why making software is hard, I’m always stunned when things go really fast and well, as they did here. Thanks for making this real, Scott!

If you run WordPress and like the idea of showing your work, let us know how it goes.

Post Revisions:

  • August 3, 2010 @ 06:31:38 [Current Revision] by Scott Rosenberg
  • August 3, 2010 @ 06:26:45 by Scott Rosenberg
  • August 3, 2010 @ 06:23:31 by Scott Rosenberg

Filed Under: Media, Mediabugs, Software

Comments

  1. Nick Martin

    August 3, 2010 at 12:47 pm

    Great move, Scott. Can’t wait to see who picks it up.

  2. D'Arcy Norman

    August 3, 2010 at 1:08 pm

    All my plugin does is expose the built-in WordPress functionality – if a person is logged in, they will have whatever access their user role allows. This could be tweaked with plugins like the Role Manager to grant view-revision privs to non-authors as well.

    Your version works much better, I think, in that it exposes the content of each revision without worrying about exposing ability to revert or edit. I may be switching over to this plugin :-)

  3. Scott Carpenter

    August 6, 2010 at 12:20 pm

    “Official” wordpress.org plugin page has been updated with this version also:

    http://wordpress.org/extend/plugins/post-revision-display/

  4. CarlosT

    August 11, 2010 at 10:25 pm

    This is good, but there are two revision tracking models I think it might be worthwhile for someone to attempt to emulate. The first is the Wikipedia model, where you select two revision and it displays the changes side by side, which makes it easy to compare. The other one, which I get the feeling is much harder to do, is Word’s Track Changes, which displays changes within the text. That would seem to me to be the most helpful way, because you’d see the changes in situ, and you’d have a better idea of what the story was like before and after.

  5. Scott Carpenter

    August 12, 2010 at 4:01 am

    Hi, CarlosT. WordPress has a built-in revision comparison that is more like Wikipedia and looks very nice. (I made a note of it and where the code is, in my post.) I’d like to use that but have to figure out how to use it in the plugin.

  6. Scott Carpenter

    August 24, 2010 at 5:56 pm

    And now with “nicer diffs” in version 0.7!

    http://wordpress.org/extend/plugins/post-revision-display/
    http://www.movingtofreedom.org/2010/07/30/wordpress-plugin-post-revision-and-diff-viewer/

  7. Carl Boettiger

    December 11, 2011 at 8:50 pm

    Thanks for an excellent idea and an excellent plugin in “Post Revision Display.” This idea is particularly popular in a section of the scientific community interested in open and transparent research, such as the Open Knowledge Foundation (http://okfn.org). I use wordpress to keep my research in an open lab notebook; an area where displaying revision history is already considered best practice, and for which reason many researchers have relied on wikis instead. (Notebook here: http://www.carlboettiger.info/research/lab-notebook)

    I’d be curious to hear if you know of other communities / uses of wordpress that have found this concept most useful.

  8. Douglas Moran

    June 16, 2015 at 8:40 pm

    @scottros You don’t even want to know how long I’ve been beating it in high tech. (Answer: Since SGML in 1992. Seriously.)

Trackbacks

  1. Two plugins to watch: Anthologize and Post Revision Display | Tech@CUNYJ says:
    August 5, 2010 at 7:01 am

    […] Post Revision Display makes public the revision history generated automatically by WordPress. The functionality is basic, I’d love to eventually see a draggable AJAX timeline and better diff visualization, but it’s a solid proof of concept. Check it out: Scott Rosenberg has it enabled on his blog. […]

  2. Post Revision Display | Brian.Carnell.Com says:
    September 7, 2010 at 11:57 am

    […] Revision Display is a WordPress plugin created by D’Arcy Norman at the instigation of Scott Rosenberg who wanted a way to publicly display any revisions made to a post after publication. The plugin […]

  3. Slate: Don’t close that corrections window — open it all the way! — Scott Rosenberg's Wordyard says:
    September 27, 2010 at 6:22 am

    […] how to expose the revisions to your readers. But it’s not a hard problem. I’m already showing all my revisions here on this blog — just look at the bottom of the full-page version of this, or any, post. […]

  4. How to turn a paper of record into a website of record — Scott Rosenberg's Wordyard says:
    October 15, 2010 at 5:37 am

    […] paper should make the previous versions available to its readers. (I’ve outlined this idea here, written about it more here, and there’s now a WordPress plugin to demonstrate it in […]

  5. How to turn a paper of record into a website of record — MediaBugs Blog says:
    October 26, 2010 at 4:54 pm

    […] paper should make the previous versions available to its readers. (I’ve outlined this idea here, written about it more here, and there’s now a WordPress plugin to demonstrate it in […]

  6. Slate: Don’t close that corrections window — open it all the way! — MediaBugs Blog says:
    October 26, 2010 at 4:56 pm

    […] how to expose the revisions to your readers. But it’s not a hard problem. I’m already showing all my revisions here on this blog — just look at the bottom of the full-page version of this, or any, post. […]

  7. The Daily vanishes into the memory hole — Scott Rosenberg's Wordyard says:
    February 11, 2011 at 8:58 am

    […] not as if the Web has solved every problem: I’ve been arguing for a long time now that news sites ought to be preserving every version of a story as it gets updated over time. I think the Web will gradually move to this […]

  8. Time to bake smart correction tools into news platforms — Scott Rosenberg's Wordyard says:
    June 20, 2011 at 11:58 am

    […] a corrections system like this is part of a larger scheme for tracking and presenting all post-publication changes to each story. The database would record the changes made to a story as part of the correction […]

  9. Time to bake smart correction tools into news platforms — MediaBugs Blog says:
    June 20, 2011 at 12:02 pm

    […] a corrections system like this is part of a larger scheme for tracking and presenting all post-publication changes to each story. The database would record the changes made to a story as part of the correction […]

  10. Three pillars of trust: Links, revisions, and error buttons — Scott Rosenberg's Wordyard says:
    June 24, 2011 at 9:50 am

    […] a longer argument for the value of versioning. Or try out the WordPress plugin. Help people report your […]

  11. NY Times: “Paper of record” no more? — Scott Rosenberg's Wordyard says:
    June 26, 2011 at 8:38 am

    […] — a volunteer organization run by a variety of ad hoc institutions — can do it. Any WordPress blog can do it. It seems peculiarly defeatist for our leading newsroom to shrug and say it can’t be […]

  12. Real time and the evolution of the news story — Tech News and Analysis says:
    July 27, 2011 at 10:04 am

    […] puts together based on Stelter’s output. On a related note, why has no one experimented with former Salon editor Scott Rosenberg’s idea of story versions, so readers can see which parts of a story have changed over […]

  13. Real time and the evolution of the news story | Information Technology | Technology News says:
    July 27, 2011 at 10:32 am

    […] puts together based on Stelter’s output. On a related note, why has no one experimented with Salon co-founder Scott Rosenberg’s idea of story versions[13], so readers can see which parts of a story have changed over […]

  14. The case of the New York Times’ terror error — Scott Rosenberg's Wordyard says:
    July 28, 2011 at 7:23 am

    […] Institutions like the Times honed their correction practices in the age of print, when appending a notice was the best feasible option. But an always-available digital page is also always editable — and is part of a rapidly evolving news ecosystem in which stopping the spread of misinformation is more important as ever. Post-publication edits can uphold that principle without being furtive or seeming to rewrite history. Any changes to long-published articles can be made transparently, either in the text of an accompanying correction notice or in an archive of previous story versions.  […]

  15. The case of the New York Times’ terror error — MediaBugs Blog says:
    July 28, 2011 at 9:02 am

    […] Institutions like the Times honed their correction practices in the age of print, when appending a notice was the best feasible option. But an always-available digital page is also always editable — and is part of a rapidly evolving news ecosystem in which stopping the spread of misinformation is more important as ever. Post-publication edits can uphold that principle without being furtive or seeming to rewrite history. Any changes to long-published articles can be made transparently, either in the text of an accompanying correction notice or in an archive of previous story versions.  […]

  16. Post Revision Display | Best Plugins - wordpress – widgets – plugin 2012 says:
    October 27, 2012 at 7:40 am

    […] Scott Rosenberg’s call for web publishers to “show your work!” […]

  17. Mathew Ingram says:
    January 16, 2015 at 1:01 pm

    retweeted this.

Leave a Reply

Your email address will not be published. Required fields are marked *