Recent Changes (Content Activity Reporting)

    Introduction

    Discovery of content activity by users and editors is currently handled through the "Recent changes" feature. This feature has received very little attention, and as different content types (like files) and activities (like comments and tags) were added, this feature has diminished in value. This spec covers changes

    This spec covers some additional changes that will allow users and editors to efficiently understand the scope of changes happening within the whole site.

    Intended Audience

    This feature will be geared for all users of MindTouch; the feature will be available as an add-on module for commercial (TBD). The first iteration of this will be available in Olympic.

    Additional information

    This work will be a precursor for enabling a richer "activity stream" experience inside MindTouch for applications.

    Status

    Initial scoping by RoyK; some components of this will be a part of Olympic release.

    Functional Specification

    Use Cases

    Users discover recent changes to a site

    Users discover recent changes to a specific hierarchy/namespace
    Users discover recent changes based on user or group
    Users discover recent changes to a specific page
    Users discover changes based on activity type
    Users discover changes based on page notifications (+ watchlists)

    Non-goals

    Technical Specification

    Activity types:

    • Page creation
    • Page edit
    • Page file
      • Attachment
      • Deleted
      • Description
    • Page comment
    • Page tagging
    • User creation
    • Page move
    • Page delete
    • Page restriction
    • Page metadata
      • Properties
      • Language?
    • Page revert
    • Page rating*
    • Page demotion/promotion*

    Points of concern:

    • How to handle aggregation of activities w/o being too smart
    • How to handle give visual feedback on discoverable activities (tagging, files)
    • How to suppress (filter) changes
    • Pagination - how to handle? (50 changes to one page collapsed into a single view looks bad)

    UI requirements

    The current table-based layout for recent changes makes no sense, as the tabular data doesn't yield any additional data. The scannability of the feed is currently atrocious (especially with move operations). The recent changes should do its best to reflect a single action as a single event and group changes as close together as possible).

    Changes to note:

    • Filtering in namespaces should effectively be boiled down to two namespaces: "Main" (NS_MAIN + NS_TALK) and "User" (NS_USER + NS_USERTALK) - thus promoting "Talk" as being tied more closely to the "Main" namespace.
    • A table-based layout isn't useful if you're not doing calculations, making data points scannable, or you're allowing sorting by data points.
      • This new design allows for quick scanning by titles, and a drilling into the changes in each title
    • Removed the per-date categorization (there's no benefit to breaking this down by day)
    • Each page which has a richer history has a "view more changes to this page link..." which will inline append five more events to that particular page's history - this is to provide additional context of changes
    • Metadata (files, comments, tags) should have actionable follow-up events within the recent changes feed
    • Events that occur as a byproduct of other events (for example, moving or deleting) should be collapsable - it should be clear from this view that each activity was a single human event, and which events were the byproduct of human events. \
    • The "Next" will inline load the next 50 (but still maintain permalinks) - in this progressive enhancement, the "previous" link becomes hidden.
    • Advanced filters:
      • Search by username & group
      • Search by page path (this could theoretically be limited down to a single page to show the page's history)
      • Do NOT allow free-form search queries here

    report_activity.png

    API requirements

    Tag page

    Files 1

    FileVersionSizeModified 
    Viewing 1 of 1 comments: view all
    @RoyK - It's something similiar of what does PagesMonitor Template: http://developer.mindtouch.com/index.php?title=App_Catalog/Monitor_changes_on_watched_pages
    Posted 00:05, 24 Mar 2010
    Viewing 1 of 1 comments: view all
    You must login to post a comment.

    Copyright © 2011 MindTouch, Inc. Powered by