update test docs

src/test/resources/tests/test_concat.jvcl

@@ -4,12 +4,12 @@
   ],
   "operations": [
     {
-      "operation": "concat",
+      "operation": "concat",              // name of the operation
+      "sources": ["vid1_splits[1..]"],    // concatentate these sources (everything but the first video in vid1_splits)
       "creates": {
-        "name": "combined_vid",
-        "dest": "src/test/resources/outputs/combined.mp4"
+        "name": "combined_vid",           // name of the output asset
+        "dest": "src/test/resources/outputs/combined.mp4" // asset will be written to this file
       },
-      "sources": ["vid1_splits[1..]"]
     }
   ]
 }

src/test/resources/tests/test_ken_burns.jvcl

@@ -1,5 +1,6 @@
 {
   "assets": [
+    // Image attribution: "1952 Jowett Javelin cars." by Alan Farrow is marked under CC PDM 1.0. To view the terms, visit https://creativecommons.org/publicdomain/mark/1.0/
     {
       "name": "javelin.jpg",
       "path": "https://live.staticflickr.com/65535/48159911972_01efa0e5ea_b.jpg",

src/test/resources/tests/test_letterbox.jvcl

@@ -5,19 +5,19 @@
   "operations": [
     {
       "operation": "letterbox",        // name of the operation
-      "creates": "boxed_wide",
+      "creates": "boxed_wide",         // name of the output asset
       "source": "vid1_splits[2]",      // box this source asset
       "width": "source.width * 2",     // width of output asset. if omitted and height is present, width will be proportional
       "height": "source.height",       // height of output asset. if omitted and width is present, height will be proportional
-      "color": "AliceBlue"
+      "color": "AliceBlue"             // letterbox padding color
     },
     {
       "operation": "letterbox",        // name of the operation
-      "creates": "boxed_tall",
+      "creates": "boxed_tall",         // name of the output asset
       "source": "vid1_splits[2]",      // box this source assets
       "width": "source.width",         // width of output asset. if omitted and height is present, width will be proportional
       "height": "source.height * 2",   // height of output asset. if omitted and width is present, height will be proportional
-      "color": "DarkCyan"
+      "color": "DarkCyan"              // letterbox padding color
     }
   ]
 }

src/test/resources/tests/test_overlay.jvcl

@@ -1,5 +1,6 @@
 {
   "assets": [
+    // these are US government videos not covered by copyright
     {
       "name": "vid1",
       "path": "https://archive.org/download/gov.archives.arc.1257628/gov.archives.arc.1257628_512kb.mp4",
@@ -12,7 +13,7 @@
     }
   ],
   "operations": [
-    // trim videos so test runs faster
+    // trim videos first, so test runs faster
     {
       "operation": "trim",
       "creates": "v1",
@@ -30,7 +31,7 @@
     {
       "operation": "overlay",          // name of the operation
       "creates": {
-        "name": "overlay1",
+        "name": "overlay1",            // name of the output asset
         "width": "1920",               // output width in pixels. default is source width
         "height": "1024",              // output height in pixes. default is source height
         "dest": "src/test/resources/outputs/overlay/"

src/test/resources/tests/test_scale.jvcl

@@ -5,7 +5,7 @@
   "operations": [
     {
       "operation": "scale",            // name of the operation
-      "creates": "scaled_test1",
+      "creates": "scaled_test1",       // output asset name
       "source": "vid1_splits[3]",      // scale this source asset
       "width": "1024",                 // width of scaled asset. if omitted and height is present, width will be proportional
       "height": "768"                  // height of scaled asset. if omitted and width is present, height will be proportional

src/test/resources/tests/test_split.jvcl

@@ -15,8 +15,8 @@
     {
       "operation": "split",          // name of the operation
       "creates": {
-        "name": "vid1_splits",
-        "dest": "src/test/resources/outputs/"
+        "name": "vid1_splits",       // output assets will have this prefix
+        "dest": "src/test/resources/outputs/" // and be written to this directory
       },
       "source": "vid1",              // split this source asset
       "interval": "10",              // split every ten seconds

src/test/resources/tests/test_trim.jvcl

@@ -6,8 +6,8 @@
     {
       "operation": "trim",          // name of the operation
       "creates": {
-        "name": "vid1_trims",
-        "dest": "src/test/resources/outputs/trims/"
+        "name": "vid1_trims",       // output assets will have this prefix
+        "dest": "src/test/resources/outputs/trims/"  // and be written to this directory
       },
       "source": "vid1_splits",       // trim these source assets
       "start": "1",                  // cropped region starts here, default is zero