Step.md

Step

Steps describe individual parts of a Trail, linking one Collection to zero or more subsequent Steps.

Think of Steps as like slides in a Powerpoint presentation or segments of a video. Unlike a 'linear' presentation however, they can be followed by n Steps, allowing 'non linear' or 'branching' presentations.

Subsequent Steps can be defined in ordered Lists or unordered Composites. This could serve as a hint to a consuming application as to how to display them.

Motivation

linking

Body

Collection

Target

• none
• Step
• List of zero or more Steps
• Composite of zero or more Steps

Examples

Single target (linear)

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "memex.global/users/userid/steps/1",
  "type": "Annotation",
  "motivation": "linking",
  "dc:title": "Step 1",
  "dc:description": "I'm the first part of trail1 linking collection 1 to step 2",
  "body": "memex.global/users/userid/collections/1",
  "target": "memex.global/users/userid/steps/2" // linear
}

Multiple ordered targets (non linear)

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "memex.global/users/userid/steps/2",
  "type": "Annotation",
  "motivation": "linking",
  "dc:title": "Step 2",
  "dc:description": "I'm the second part of trail1 linking collection2 to step 3 and step 4",
  "body": "memex.global/users/userid/collections/2",
  "target": {
    "type": "List", // specific order
    "items": [
      "memex.global/users/userid/steps/3",
      "memex.global/users/userid/steps/4"
    ]
  }
}

Multiple unordered targets (non linear)

{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "id": "memex.global/users/userid/steps/2",
  "type": "Annotation",
  "motivation": "linking",
  "dc:title": "Step 2",
  "dc:description": "I'm the second part of trail1 linking collection2 to step 3 and step 4",
  "body": "memex.global/users/userid/collections/2",
  "target": {
    "type": "Composite", // no specific order
    "items": [
      "memex.global/users/userid/steps/3",
      "memex.global/users/userid/steps/4"
    ]
  }
}