activitystreams / activity-schema Goto Github PK

Objects have 'content' (the bulk) and 'summary', but activities have 'content'. I argue that an activity’s content is actually it’s object, and that having activity.summary as a short human readable summary of the activity would be more appropriate.

E.G. if I have:

note.summary = "This is a medium length, tweet-like note for use in an example. This is a medium length, tweet-like note for use in an example. It has a <a href="">HTML link</a> in."
note.displayName = "This is a medium length, tweet-like note for use in an example. This is a…"

It’s associated post activity should look like this:

activity.object = note
activity.summary = "This is a medium length, tweet-like note for use in an example. This is a…"
activity.title = "Barnaby posted a note"

(I have obviously left out various properties for brevity)

Hi,

I've been playing with mroth/lolcommits, and making a plugin for e14n/pump.io, which uses ActivityStreams at its core. At the moment, I'm simply posting an image object with the commit message as its title/content, same as the Twitter plugins did, but @evanp suggested to use a more semantically-correct activity.

There doesn't seem to be any provision to represent repositories and commits so far, so I thought this issue could start a discussion about it.

In my understanding, we would need some basic concepts of repositories, which might need to be specialised for a specific SCM (e.g., Git, SVN, ...), and then add new verbs to represent commits (probably pushes too (see lolcommits/lolcommits#142). Aliases of “add” or “append” should do the trick.

Any thoughts?

So I am working on a Cloud Foundry app that stores and resizes pictures with ImageMagick which can then be shared to the stream. I have the original photo, a stream sized photo and a thumbnail.
I went to the schema spec to lookup the latest JSON representation. I had a hard time finding it and even pinged Martin to help me look.
I cannot find the full representation here
http://activitystrea.ms/specs/json/schema/activity-schema.html

The net net is that the different Object Types are not linked from the top of the document or TOC as they used to a year ago as you can see here
http://activitystrea.ms/head/activity-schema.html

Overall the spec seems a bit confusing compared to what we had a while back that showed all the properties.
http://wiki.activitystrea.ms/w/page/23768198/Photo

The semantics of 'title' and 'name' are different. Name refers to the name of an object, title to how the name is displayed (e.g. the name of a book might be "The Hunting of the Snark" but 'title' refers to the physical manifestation of that).

So 'displayName' effectively equals 'title', as 'title' is the physical manifestation of a name.

The schema states that an AS task is an activity which has yet to be completed. What happens when the task is completed? Surely the object type should not change.

In the examples the verbs are past tense:

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

But the spec the documentation says to use lists example verbs in present tense. The examples in the documentation also sometimes show a phrase but the spec always uses a single word or kebab-cased identifier. I believe the examples in the documentation should follow the spec to use verbs as a single word or as an identifier as it is more correct. This approach also makes for cleaner i8n.

Stream framework also leads with the infinitive https://stream-framework.readthedocs.io/en/latest/verbs.html.