Pipes api documentation and tidying up
merged pipe api fixes from dev-pipes
Merge branch 'dev' of github.com:alex-lawson/sb-automation into dev