WIP [Docs] Add docs on version workflows

Signed-off-by: Tom Cowland <tom@foundry.com>

.gitignore

@@ -1 +1,2 @@
 *.egg-info
+.ipynb_checkpoints

examples/resources/helpers.py

@@ -0,0 +1,29 @@
+import json
+
+from IPython.display import display
+from PIL import Image
+from urllib.parse import urlparse, unquote
+
+def print_traits_data(data):
+    """
+    TraitsData objects arent readily convertable to a dict, or printable 
+    at present. This is a little helper to aid the display of OpenAssetIO
+    data in the context of a notebook. It prints the traits and their
+    properties using pretty json formatting.
+    """
+    as_dict = {
+        trait_id: {
+            property_key: data.getTraitProperty(trait_id, property_key)
+            for property_key in data.traitPropertyKeys(trait_id)
+        }
+        for trait_id in data.traitSet()
+    }
+    print(json.dumps(as_dict, indent=4, sort_keys=True))
+
+def display_image(url):
+    """
+    Displays an image in the notebook output.
+    """
+    url_parts = urlparse(url)
+    image = Image.open(unquote(url_parts.path))
+    display(image)

examples/resources/requirements.txt

@@ -0,0 +1,3 @@
+openassetio>=v1.0.0b1rev0
+openassetio-mediacreation
+Pillow

examples/resources/versioning/bal_database.json

@@ -0,0 +1,44 @@
+{
+  "managementPolicy": {
+    "read": {
+      "default": {
+        "openassetio-mediacreation:managementPolicy.Managed": {},
+        "openassetio-mediacreation:content.LocatableContent": {}
+      }
+    },
+    "write": {
+      "default": {
+        "openassetio-mediacreation:managementPolicy.Managed": {},
+        "openassetio-mediacreation:content.LocatableContent": {}
+      }
+    }
+  },
+  "entities": {
+    "project_artwork/logos/openassetio": {
+      "versions": [
+        {
+          "traits": {
+            "openassetio-mediacreation:identity.DisplayName": {
+              "name": "The OpenAssetOI logo",
+              "qualifiedName": "logos / openassetio / v1"                
+            },
+            "openassetio-mediacreation:content.LocatableContent": {
+              "location": "file:///${bal_library_dir}/logo.jpg"
+            }
+          }
+        },
+        {
+          "traits": {
+            "openassetio-mediacreation:identity.DisplayName": {
+              "name": "The OpenAssetIO logo",
+              "qualifiedName": "logos / openassetio / v2"                
+            },
+            "openassetio-mediacreation:content.LocatableContent": {
+              "location": "file:///${bal_library_dir}/logo_revised.jpg"
+            }
+          }
+        }
+      ]
+    }
+  }
+}

examples/resources/versioning/openassetio_config.toml

@@ -0,0 +1,5 @@
+[manager]
+identifier = "org.openassetio.examples.manager.bal"
+
+[manager.settings]
+library_path = "${config_dir}/bal_database.json"