multi file api & documentation

README.md

@@ -2,6 +2,77 @@
 
 This is the development repository for the new StirlingPDF backend. With the power of JS, WASM & GO this will provide almost all functionality SPDF can do currently directly on the client. For automation purposes this will still provide an API to automate your workflows.
 
+## Try the new API!
+
+[![Run in Postman](https://run.pstmn.io/button.svg)](https://documenter.getpostman.com/view/30633786/2s9YRB1Wto)
+
+## Understanding Workflows
+
+Workflows are the way you define what operations and their order should be applied to the PDF.
+
+Workflows can be created via the web-ui and then exported or, if you want to brag a bit, you can create the JSON object yourself.
+
+### Basics
+
+To create your own, you have to understand a few key features first. You can also look at more examples our github repository.
+
+``` json
+{
+  "outputOptions": {
+    "zip": false
+  },
+  "operations": [
+    {
+      "type": "extract",
+      "values": {
+        "pagesToExtractArray": [0, 2]
+      },
+      "operations": []
+    }
+  ]
+}
+```
+
+The workflow above will extract the first (p\[0\]) and third (p\[2\]) page of the document.
+
+You can also nest workflows like this:
+
+``` json
+{
+  "outputOptions": {
+    "zip": false
+  },
+  "operations": [
+    {
+      "type": "extract",
+      "values": {
+        "pagesToExtractArray": [0, 2]
+      },
+      "operations": [
+        {
+          "type": "impose",
+          "values": {
+            "nup": 2, // 2 pages of the input docuemtn will be put on one page of the output document.
+            "format": "A4L" // A4L -> The page size of the Ouput will be an A4 in Landscape. You can also use other paper formats and "P" for portrait output. 
+          },
+          "operations": []
+        }
+      ]
+    }
+  ]
+}
+```
+
+If you look at it closely, you will see that the extract operation has another nested operation of the type impose. This workflow will produce a PDF with the 1st and 2nd page of the input on one single page.
+
+### Advanced
+
+If that is not enought for you usecase, there is also the possibility to connect operations with eachother.
+
+You can also do different operations to produce two different output PDFs from one input.
+
+If you are interested in learning about this, take a look at the Example workflows provided in the repository, ask on the discord, or wait for me to finish this documentation.
+
 ## Features
 
 ### New