Activity Stream Concepts

The terminiology used in this app is based from the Activity Streams Specification. The app currently supports the version 1.0 terminology.

Introduction

http://activitystrea.ms/specs/json/1.0/#introduction

In its simplest form, an activity consists of an actor, a verb, an an object, and a target. It tells the story of a person performing an action on or with an object – “Geraldine posted a photo to her album” or “John shared a video”. In most cases these components will be explicit, but they may also be implied.

It is a goal of this specification to provide sufficient metadata about an activity such that a consumer of the data can present it to a user in a rich human-friendly format. This may include constructing readable sentences about the activity that occurred, visual representations of the activity, or combining similar activities for display.

The basic properties that comprise the description of an activity are defined in the following sections.

Within this specification, an object is a thing, real or imaginary, which participates in an activity. It may be the entity performing the activity, or the entity on which the activity was performed. An object consists of properties defined in the following sections. Certain object types may further refine the meaning of these properties, or they may define additional properties.

Definitions

Activities are defined by four main components. Here are their definitions from the specification.

  • Actor. The object that performed the activity.

    An Object Construct that identifies the entity that performed the activity. An Activity construct MUST have exactly one actor.

  • Verb. The verb phrase that identifies the action of the activity.

    An IRI reference that identifies the action of the activity. This value MUST be an absolute IRI, or a IRI relative to the base IRI of http://activitystrea.ms/schema/1.0/. An Activity construct MUST have exactly one verb.

  • Action Object. (Optional) The object linked to the action itself.

    This Object Construct identifies the primary object of the activity. An Activity construct MUST have exactly one object.

  • Target. (Optional) The object to which the activity was performed.

    The target of an activity is an Object Construct that represents the object to which the activity was performed. The exact meaning of an activity’s target is dependent on the verb of the activity, but will often be the object of the English preposition “to”. For example, in the activity “John saved a movie to his wishlist”, the target of the activity is “wishlist”. The activity target MUST NOT be used to identify an indirect object that is not a target of the activity. An Activity construct MAY have a target but it MUST NOT have more than one.

Actor, Action Object and Target are all Object Constructs which are defined as

An Object Construct is a thing, real or imaginary, which participates in an activity. It may be the entity performing the activity, or the entity on which the activity was performed. An object consists of the logical components defined in the following sections. Certain object types may further refine the meaning of these components, or they may define additional components. If an object type defines an additional component then it SHOULD also define the representation of that component in one or more serialization formats.

Example

justquick (actor) closed (verb) issue 2 (object) on django-activity-stream (target) 12 hours ago