activity-streams: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(drafted)
 
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<h1>activity streams</h1>
{{DISPLAYTITLE:activity streams}}
{{TOC-right}}
== introduction ==
== introduction ==
As people use various different web sites to [[blogging-tools|blog]], update their [[picoformats|status]], post their [[geo|location]], or [[photo-info|photos]], sites and tools have emerged to aggregate these various actions into a continuous eclectic stream of activities.
As people use various different web sites to [[blogging-tools|blog]], update their [[picoformats|status]], post their [[geo|location]], or [[photo-info|photos]], sites and tools have emerged to aggregate these various actions into a continuous eclectic stream of activities.
Line 6: Line 5:
Such activities typically involve a '''subject''' (the person doing the activity), a '''verb''' (what the "doing" is of the activity), and often a '''direct object''' (what the activity is being done to or with). Activity stream aggregators typically republish activities in reverse chronological order, independent of type of activity.
Such activities typically involve a '''subject''' (the person doing the activity), a '''verb''' (what the "doing" is of the activity), and often a '''direct object''' (what the activity is being done to or with). Activity stream aggregators typically republish activities in reverse chronological order, independent of type of activity.


[http://friendfeed.com Friendfeed] is perhaps the most well known web site that does cross site activity aggregation/publication, and [[movable-type|Movable Type]] has built-in support for aggregation/publication of activity streams as of v4.1.
[http://friendfeed.com Friendfeed] was perhaps the most well known web site that does cross site activity aggregation/publication, and [[movable-type|Movable Type]] has (had?) built-in support for aggregation/publication of activity streams as of v4.1.


For more examples, see the [http://diso-project.org/wiki/activity-streams DiSo wiki activity streams page].
For more examples, see the [http://diso-project.org/wiki/activity-streams DiSo wiki activity streams page] (see also [http://wiki.diso-project.org/ the other DiSo wiki], not sure [http://twitter.com/t/status/972796117 which to use]).


== problem statement ==
== problem statement ==
Line 21: Line 20:


The '''direct object''' of an activity is typically an item or entry in a feed.
The '''direct object''' of an activity is typically an item or entry in a feed.
Sites that publish different kinds of objects/items in their interfaces often present those items/posts differently depending on the kind of object.  Activity Streams thus has a set of object-types that represent these kinds of objects, based on their research on existing object type publishing examples in the wild.


== apparent need and focus ==
== apparent need and focus ==
Thus the only remaining piece that seems to be missing to standardize is the '''verb''' aspect of an activity.
Thus key pieces that seem worthy of standardization are:
* the '''verb''' aspect of an activity
* the '''object-type''' of an item or post


Per the [[microformats]] [[principles]], by focusing on this smaller part of the problem (verbs), we may be able to more quickly solve the larger problem of representing activities and activity streams.
Per the [[microformats]] [[principles]], by focusing on these smaller parts of the problem (verbs and object-types), we may be able to more quickly solve the larger problem of representing activities and activity streams.


Thus, per the microformats [[process]]:
Thus, per the microformats [[process]]:
Line 32: Line 35:
* [[activity-verb-formats]]
* [[activity-verb-formats]]
* [[activity-verb-brainstorming]]
* [[activity-verb-brainstorming]]
And:
* [[activity-object-examples]]
* [[activity-object-formats]]
* [[activity-object-brainstorming]]
== rejected brainstorms ==
The following brainstorm proposals have been found to be problematic for various reasons.
=== activity object brainstorm ===
{{warning|This activity object brainstorm is no longer recommended, and actively discouraged.''' See https://indieweb.org/h-as for more background, experience, and reasons why.}}
Previous brainstorm thoughts and proposal:
Strawman brainstorm (to be archived as a past attempt [[activity-object-brainstorming]]) : for now, try simply re-using the Activity Streams set of object-types as class names, preceded with "h-as-", as a [[microformats2]] poshformat for representing different Activity Stream object-types in [[hAtom]]. Use these object-type class names to "subclass" the "h-entry" class in hAtom, e.g. where you might publish
<source lang=html4strict>
<div class="h-entry hentry">
</source>
With this strawman proposal, for blog posts you might publish:
<source lang=html4strict>
<div class="h-entry hentry h-as-article">
</source>
Or for little tweet/text notes:
<source lang=html4strict>
<div class="h-entry hentry h-as-note">
</source>
And [[rsvp|RSVPs]] (as [[rsvp-brainstorming|brainstormed]]) :
<source lang=html4strict>
<div class="h-entry hentry h-as-rsvp">
</source>
==== sites implementing activity object brainstorm ====
See: http://indiewebcamp.com/ActivityStreams#Use_with_microformats2


== see also ==
== see also ==
* [[h-entry]]
* [[hAtom]]
* [[hAtom]]
* [[events/2008-10-21-sf-weekly-meetup-dinner]]
* [[events/2008-10-21-sf-weekly-meetup-dinner]]
* [http://wiki.activitystrea.ms/Microformats-for-Activities ActivityStrea.ms Wiki Page for Microformats]
* http://indiewebcamp.com/activitystreams
* [http://www.sandeep.io/50 RSSB microformats to Activity Streams]

Latest revision as of 16:20, 18 July 2020

introduction

As people use various different web sites to blog, update their status, post their location, or photos, sites and tools have emerged to aggregate these various actions into a continuous eclectic stream of activities.

Such activities typically involve a subject (the person doing the activity), a verb (what the "doing" is of the activity), and often a direct object (what the activity is being done to or with). Activity stream aggregators typically republish activities in reverse chronological order, independent of type of activity.

Friendfeed was perhaps the most well known web site that does cross site activity aggregation/publication, and Movable Type has (had?) built-in support for aggregation/publication of activity streams as of v4.1.

For more examples, see the DiSo wiki activity streams page (see also the other DiSo wiki, not sure which to use).

problem statement

The type and variety of activities that services support and publish is growing every month. Services like Friendfeed and tools like Movable Type must either be continuously updated with one-off per service implementation support, or provide nothing more than lowest common denominator feed aggregation and publication.

If activity streams were published in an open standard format then activity stream aggregators that supported such an open format would automatically support any new standards supporting activity stream services without having to play the continuous one-off proprietary API implementation catch-up game. In addition, new activity publishers would be less beholden to trying to reimplement others' proprietary APIs (and all the giving up control to a likely competitor problems that arise from that practice).

existing standards

Feeds (and related formats, RSS, Atom, hAtom) solve most of the problems of activity streams. Movable Type 4.1's activity stream publishing support already supports hAtom today for example.

The subject of an activity is nearly always the author of a feed.

The direct object of an activity is typically an item or entry in a feed.

Sites that publish different kinds of objects/items in their interfaces often present those items/posts differently depending on the kind of object. Activity Streams thus has a set of object-types that represent these kinds of objects, based on their research on existing object type publishing examples in the wild.

apparent need and focus

Thus key pieces that seem worthy of standardization are:

  • the verb aspect of an activity
  • the object-type of an item or post

Per the microformats principles, by focusing on these smaller parts of the problem (verbs and object-types), we may be able to more quickly solve the larger problem of representing activities and activity streams.

Thus, per the microformats process:

And:

rejected brainstorms

The following brainstorm proposals have been found to be problematic for various reasons.

activity object brainstorm

⚠️ Warning: This activity object brainstorm is no longer recommended, and actively discouraged. See https://indieweb.org/h-as for more background, experience, and reasons why.

Previous brainstorm thoughts and proposal:

Strawman brainstorm (to be archived as a past attempt activity-object-brainstorming) : for now, try simply re-using the Activity Streams set of object-types as class names, preceded with "h-as-", as a microformats2 poshformat for representing different Activity Stream object-types in hAtom. Use these object-type class names to "subclass" the "h-entry" class in hAtom, e.g. where you might publish

<div class="h-entry hentry">

With this strawman proposal, for blog posts you might publish:

<div class="h-entry hentry h-as-article">

Or for little tweet/text notes:

<div class="h-entry hentry h-as-note">

And RSVPs (as brainstormed) :

<div class="h-entry hentry h-as-rsvp">

sites implementing activity object brainstorm

See: http://indiewebcamp.com/ActivityStreams#Use_with_microformats2

see also