From 883826735fe9dbd8b87b51e7556ffafeda8586a8 Mon Sep 17 00:00:00 2001 From: anablaz Date: Wed, 28 Feb 2024 01:02:50 +0100 Subject: [PATCH 1/2] Replace links and references to Template Studio with Template Playground Signed-off-by: anablaz --- docs/accordproject-faq.md | 4 ++-- docs/accordproject-template.md | 2 +- docs/accordproject-tour.md | 18 ++++++++--------- docs/started-resources.md | 2 +- docs/tutorial-studio.md | 6 +++--- website/i18n/en.json | 10 +++++----- website/pages/en/index.js | 2 +- .../version-0.12/accordproject-studio.md | 4 ++-- .../version-0.12/accordproject-tooling.md | 4 ++-- .../version-0.12/accordproject.md | 6 +++--- .../version-0.12/advanced-hyperledger.md | 16 +++++++-------- .../version-0.12/advanced-latedelivery.md | 6 +++--- .../version-0.20/accordproject-business.md | 2 +- .../version-0.20/accordproject-concepts.md | 2 +- .../version-0.20/accordproject-developers.md | 2 +- .../version-0.20/ref-cicero-ui.md | 2 +- .../version-0.20/started-resources.md | 2 +- .../version-0.20/started-studio.md | 20 +++++++++---------- .../version-0.20/tutorial-hyperledger.md | 16 +++++++-------- .../version-0.20/tutorial-latedelivery.md | 4 ++-- .../version-0.21/accordproject-faq.md | 4 ++-- .../version-0.21/accordproject-template.md | 2 +- .../version-0.21/accordproject-tour.md | 18 ++++++++--------- .../version-0.21/started-resources.md | 2 +- .../version-0.21/tutorial-studio.md | 6 +++--- .../version-0.22/tutorial-studio.md | 6 +++--- .../version-0.30.1/accordproject-faq.md | 4 ++-- .../version-0.30.1/accordproject-template.md | 2 +- .../version-0.30.1/started-resources.md | 2 +- .../version-0.20-sidebars.json | 2 +- 30 files changed, 89 insertions(+), 89 deletions(-) diff --git a/docs/accordproject-faq.md b/docs/accordproject-faq.md index d93d4a3d..9acb0b53 100644 --- a/docs/accordproject-faq.md +++ b/docs/accordproject-faq.md @@ -50,9 +50,9 @@ The Accord Project Community is developing several working groups focusing on di A primary purpose of the working groups is to develop a universally accessible and widely used open source library of modular, smart legal contracts, smart templates and models that reflect input from the community. Smart legal contract templates are built according to the Project’s [Cicero Specification](https://github.com/accordproject/cicero). -Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Studio](https://studio.accordproject.org/). +Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Playground](https://playground.accordproject.org/). The Accord Project has developed an easy-to-use programming language for building and executing smart legal contracts called Ergo. The goals of Ergo are to be accessible and usable by non-technical professionals, portable across, and compatible with, a variety of environments such as SaaS platforms and different blockchains, and meeting security, safety, and other requirements. -You can use the Accord Project’s [Template Studio](https://studio.accordproject.org/) to create and test your smart legal contracts. +You can use the Accord Project’s [Template Playground](https://playground.accordproject.org/) to create and test your smart legal contracts. diff --git a/docs/accordproject-template.md b/docs/accordproject-template.md index fb7c2543..c4564fff 100644 --- a/docs/accordproject-template.md +++ b/docs/accordproject-template.md @@ -205,7 +205,7 @@ Let's look at each component of the template triangle, starting with the text. ### What next? -Build your first smart legal contract templates, either [online](tutorial-studio.md) with Template Studio, or by [installing Cicero](started-installation.md). +Build your first smart legal contract templates, either [online](tutorial-studio.md) with Template Playground, or by [installing Cicero](started-installation.md). Explore [sample templates](started-resources.md) and other resources in the rest of this documentation. diff --git a/docs/accordproject-tour.md b/docs/accordproject-tour.md index cd1bea20..71fb58f0 100644 --- a/docs/accordproject-tour.md +++ b/docs/accordproject-tour.md @@ -3,29 +3,29 @@ id: accordproject-tour title: Online Tour --- -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Studio](https://studio.accordproject.org) editor. +To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. :::tip -You can open template studio from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. +You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. ::: -The following video offers a tour of Template Studio and an introduction to the key concepts behind the Accord Project technology. +The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. Here is a timestamp of what is covered in the video: -- **00:08** : Introduction to template Studio & pointers the other parts of the docs / AP website +- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website - **03:51** : Helloworld template tutorial start -- **04:48** : Template Studio - Metadata -- **06:56** : Template Studio - Contract Text +- **04:48** : Template Playground - Metadata +- **06:56** : Template Playground - Contract Text - **07:52** : The 'live' nature of the text; how to read errors - **08:39** : Changing the template text itself - **09:17** : Changing the variables in the template text -- **10:00** : Template Studio - Model update -- **11:28** : Template Studio - Logic update +- **10:00** : Template Playground - Model update +- **11:28** : Template Playground - Logic update - **13:17** : Explanation about request types / response types -- **14:44** : Template Studio - Logic - Test Execution (request, response) +- **14:44** : Template Playground - Logic - Test Execution (request, response) - **15:57** : Test Execution - contract state - **16:49** : Test Execution - obligations - **18:20** : Wrap-up diff --git a/docs/started-resources.md b/docs/started-resources.md index 2e19e4a8..1971f067 100644 --- a/docs/started-resources.md +++ b/docs/started-resources.md @@ -23,7 +23,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/docs/tutorial-studio.md b/docs/tutorial-studio.md index 47386834..d801a41d 100644 --- a/docs/tutorial-studio.md +++ b/docs/tutorial-studio.md @@ -1,9 +1,9 @@ --- id: tutorial-studio -title: With Template Studio +title: With Template Playground --- -This tutorial will walk you through the steps of editing a clause template in [Template Studio](https://studio.accordproject.org/). +This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -11,7 +11,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Studio" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Playground" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/i18n/en.json b/website/i18n/en.json index 7cddeebf..451aa8d2 100644 --- a/website/i18n/en.json +++ b/website/i18n/en.json @@ -138,7 +138,7 @@ "title": "With Node.js" }, "tutorial-studio": { - "title": "With Template Studio" + "title": "With Template Playground" }, "tutorial-templates": { "title": "Templates Deep Dive" @@ -156,7 +156,7 @@ "title": "Learning Resources" }, "version-0.12/version-0.12-accordproject-studio": { - "title": "Template Studio" + "title": "Template Playground" }, "version-0.12/version-0.12-accordproject-templates": { "title": "Open Source Templates" @@ -171,7 +171,7 @@ "title": "Deploying on Hyperledger Fabric" }, "version-0.12/version-0.12-advanced-latedelivery": { - "title": "Authoring in Template Studio" + "title": "Authoring in Template Playground" }, "version-0.12/version-0.12-advanced-nodejs": { "title": "Working with Node.js" @@ -588,7 +588,7 @@ "title": "With Node.js" }, "version-0.21/version-0.21-tutorial-studio": { - "title": "With Template Studio" + "title": "With Template Playground" }, "version-0.21/version-0.21-tutorial-templates": { "title": "Templates Deep Dive" @@ -633,7 +633,7 @@ "title": "With Node.js" }, "version-0.22/version-0.22-tutorial-studio": { - "title": "With Template Studio" + "title": "With Template Playground" }, "version-0.22/version-0.22-tutorial-templates": { "title": "Templates Deep Dive" diff --git a/website/pages/en/index.js b/website/pages/en/index.js index afb1623b..d9588cbd 100755 --- a/website/pages/en/index.js +++ b/website/pages/en/index.js @@ -204,7 +204,7 @@ const TryOut = props => ( {[ { content: - '
You can author and test templates online in the Accord Project Template Studio. Search for existing templates, edit the contract text and execute the logic.
', + '
You can author and test templates online in the Accord Project Template Playground. Search for existing templates, edit the contract text and execute the logic.
', image: imgUrl("../docs/assets/020/studio.png"), imageAlt: "An example a template being edited. There is an option to edit the full contract or a single clause. There is also a search bar at the top center for users to search for specific templates.", diff --git a/website/versioned_docs/version-0.12/accordproject-studio.md b/website/versioned_docs/version-0.12/accordproject-studio.md index 5cdbbe6d..12fdc5ef 100644 --- a/website/versioned_docs/version-0.12/accordproject-studio.md +++ b/website/versioned_docs/version-0.12/accordproject-studio.md @@ -1,9 +1,9 @@ --- id: version-0.12-accordproject-studio -title: Template Studio +title: Template Playground original_id: accordproject-studio --- -[Template Studio](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project. +[Template Playground](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project. ![Model Repository](/img/studio.png) diff --git a/website/versioned_docs/version-0.12/accordproject-tooling.md b/website/versioned_docs/version-0.12/accordproject-tooling.md index be961aff..3b3633c7 100644 --- a/website/versioned_docs/version-0.12/accordproject-tooling.md +++ b/website/versioned_docs/version-0.12/accordproject-tooling.md @@ -29,8 +29,8 @@ A simple VIM mode for Ergo can be found in the [ergo.vim](https://github.com/acc > Those are not maintained as actively as the rest of the Accord Project. If you know emacs lisp or are a VIM user and would like to contribute, please contact us on the Accord Project Slack or directly through GitHub! -## Template Studio +## Template Playground -Finally, [Template Studio](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project directly from your browser, without having to install anything. +Finally, [Template Playground](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project directly from your browser, without having to install anything. ![Model Repository](/img/studio.png) diff --git a/website/versioned_docs/version-0.12/accordproject.md b/website/versioned_docs/version-0.12/accordproject.md index eef71b32..8f1f903c 100644 --- a/website/versioned_docs/version-0.12/accordproject.md +++ b/website/versioned_docs/version-0.12/accordproject.md @@ -67,7 +67,7 @@ Beyond a core technology for executable legal templates, Accord Project is build Several tools are also available to facilitate authoring of Accord Project templates: -- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) ## Open Source Community @@ -78,9 +78,9 @@ Join the Accord Project Technology Working Group diff --git a/website/versioned_docs/version-0.12/advanced-hyperledger.md b/website/versioned_docs/version-0.12/advanced-hyperledger.md index c8fc8583..6186cbd9 100644 --- a/website/versioned_docs/version-0.12/advanced-hyperledger.md +++ b/website/versioned_docs/version-0.12/advanced-hyperledger.md @@ -57,11 +57,11 @@ Once you've provisioned your server, install all of the required tools using the - [Git](https://www.digitalocean.com/community/tutorials/how-to-install-git-on-ubuntu-18-04) - [Fabric](https://hyperledger-fabric.readthedocs.io/en/release-1.3/getting_started.html) -## Create your Smart Legal Contract with Template Studio +## Create your Smart Legal Contract with Template Playground -Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Studio](https://studio.accordproject.org/). +Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Playground](https://playground.accordproject.org/). -Template Studio is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. +Template Playground is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. This tutorial uses the `supplyagreement-perishable-goods` template. This Smart Legal Agreement combines a plaintext contract for the shipment of goods that impose conditions on temperature and humidity until the shipment is delivered. @@ -73,9 +73,9 @@ Once you've connected to your system, open https://studio.accordproject.org in a In the hosted images, Mozilla Firefox is preinstalled, click the icon on the top-left toolbar to launch it. ::: -The Template Studio allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). +The Template Playground allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). -> In the Template Studio search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. +> In the Template Playground search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. Explore the source components of the template. @@ -100,7 +100,7 @@ The _Obligations_ that are emitted by the contract are configured to be emitted Save your CTA (Cicero Template Archive) file somewhere safe, as you'll need to use it in a later step. We suggest saving the file in user's the home folder. -> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Studio. +> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Playground. For example: ```json @@ -123,7 +123,7 @@ For example: } ``` -Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Studio. +Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Playground. :::note It's important that your sample contract text exactly matches your grammar's structure, this includes trailing spaces and line breaks. To be sure that you copy everything, right click the window and choose Select All, before choosing Copy. @@ -233,7 +233,7 @@ Take a look at some of the other stateful Cicero Templates to see what changes y If you get really stuck, a solution is available for you to [download](https://drive.google.com/file/d/1cak_P_x01w8dz43aZX8N16G5DUNp6VbG/view?usp=sharing). ::: 2. Explore the source code of the Cicero chaincode shim that transforms your requests and deployments into Fabric transactions using the Fabric Node SDK. https://github.com/clauseHQ/fabric-samples/tree/master/chaincode/cicero -3. Create your own template from scratch using [Template Studio](https://studio.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). +3. Create your own template from scratch using [Template Playground](https://playground.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). ![Change Test Contract](assets/advanced/hlf4.png) > A separate tutorial for creating a template using the Cicero CLI tool can be found in [Creating a New Template](basic-create). diff --git a/website/versioned_docs/version-0.12/advanced-latedelivery.md b/website/versioned_docs/version-0.12/advanced-latedelivery.md index 3e3099a3..973fcb7f 100644 --- a/website/versioned_docs/version-0.12/advanced-latedelivery.md +++ b/website/versioned_docs/version-0.12/advanced-latedelivery.md @@ -1,10 +1,10 @@ --- id: version-0.12-advanced-latedelivery -title: Authoring in Template Studio +title: Authoring in Template Playground original_id: advanced-latedelivery --- -This tutorial will walk you through the steps of authoring a clause template in [Template Studio](https://studio.accordproject.org/). +This tutorial will walk you through the steps of authoring a clause template in [Template Playground](https://playground.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at https://templates.accordproject.org/minilatedeliveryandpenalty@0.2.1.html and click the "Open In Template Studio" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at https://templates.accordproject.org/minilatedeliveryandpenalty@0.2.1.html and click the "Open In Template Playground" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.20/accordproject-business.md b/website/versioned_docs/version-0.20/accordproject-business.md index 0e8469e7..c7157826 100644 --- a/website/versioned_docs/version-0.20/accordproject-business.md +++ b/website/versioned_docs/version-0.20/accordproject-business.md @@ -29,4 +29,4 @@ If you are new to the Accord Project, the best place to start is our [Online Tou If any of the technical terms are confusing or hard to understand, we have a [Glossary](ref-glossary) page that may help you. If there are any concepts or terms that you want to include in the Glossary, please join our [slack channel](https://accord-project-slack-signup.herokuapp.com/) and make suggestions! -If you want to create a template yourself, please see [Authoring in Template Studio](tutorial-latedelivery) for a step-by-step guide on how to create your first template. The tutorial will provide an accessible starting point for those without significant development experience to begin building smart legal contracts using the Accord Project technology. +If you want to create a template yourself, please see [Authoring in Template Playground](tutorial-latedelivery) for a step-by-step guide on how to create your first template. The tutorial will provide an accessible starting point for those without significant development experience to begin building smart legal contracts using the Accord Project technology. diff --git a/website/versioned_docs/version-0.20/accordproject-concepts.md b/website/versioned_docs/version-0.20/accordproject-concepts.md index 8c01b993..f6b76f6b 100644 --- a/website/versioned_docs/version-0.20/accordproject-concepts.md +++ b/website/versioned_docs/version-0.20/accordproject-concepts.md @@ -208,7 +208,7 @@ _More information about Ergo can be found in the [Ergo Logic](logic-ergo) Sectio ## What next? -Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Studio, or by [installing Cicero](started-installation). +Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Playground, or by [installing Cicero](started-installation). Explore [sample templates](started-resources) and other resources in the rest of this documentation. diff --git a/website/versioned_docs/version-0.20/accordproject-developers.md b/website/versioned_docs/version-0.20/accordproject-developers.md index e1b191af..687ab07c 100644 --- a/website/versioned_docs/version-0.20/accordproject-developers.md +++ b/website/versioned_docs/version-0.20/accordproject-developers.md @@ -16,7 +16,7 @@ If this interests you, please visit our [Technology Working Group](https://www.a If you want to author, validate, and run Accord Project templates locally, please visit our [Install Cicero](https://docs.accordproject.org/docs/next/started-installation.html) page for instructions. -If you are new to the Accord Project, please read the [Key Concepts](accordproject-concepts) page. This will allow you to understand the three components of a template (text, model, and logic) and how they work together. If you want some guidance on creating your first template, please see [Authoring in Template Studio](tutorial-latedelivery) for a step-by-step guide on how to create your first template. +If you are new to the Accord Project, please read the [Key Concepts](accordproject-concepts) page. This will allow you to understand the three components of a template (text, model, and logic) and how they work together. If you want some guidance on creating your first template, please see [Authoring in Template Playground](tutorial-latedelivery) for a step-by-step guide on how to create your first template. If you want to dive into our technology stack, you can find more information about: - Software implementation: [Cicero](https://github.com/accordproject/cicero) diff --git a/website/versioned_docs/version-0.20/ref-cicero-ui.md b/website/versioned_docs/version-0.20/ref-cicero-ui.md index 21e17b26..30201180 100644 --- a/website/versioned_docs/version-0.20/ref-cicero-ui.md +++ b/website/versioned_docs/version-0.20/ref-cicero-ui.md @@ -6,7 +6,7 @@ original_id: ref-cicero-ui Accord Project publishes [React](https://reactjs.org) user interface components for use in web-applications. Please refer to the cicero-ui project [on GitHub](https://github.com/accordproject/cicero-ui) for detailed usage instructions. -You can preview these components in [Template Studio v2](https://accordproject-studio.netlify.com). +You can preview these components in [Template Playground v2](https://accordproject-studio.netlify.com). ![Template-Studio-V2](/docs/assets/reference/tsv2.png) diff --git a/website/versioned_docs/version-0.20/started-resources.md b/website/versioned_docs/version-0.20/started-resources.md index 823f7a2d..4d4f179c 100644 --- a/website/versioned_docs/version-0.20/started-resources.md +++ b/website/versioned_docs/version-0.20/started-resources.md @@ -24,7 +24,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/website/versioned_docs/version-0.20/started-studio.md b/website/versioned_docs/version-0.20/started-studio.md index e9fc596a..e3e4c162 100644 --- a/website/versioned_docs/version-0.20/started-studio.md +++ b/website/versioned_docs/version-0.20/started-studio.md @@ -4,33 +4,33 @@ title: Online Tour original_id: started-studio --- -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Studio](https://studio.accordproject.org) editor. +To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. :::tip -You can open template studio from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. +You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. ::: -The following video offers a tour of Template Studio and an introduction to the key concepts behind the Accord Project technology. +The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. Here is a timestamp of what is covered in the video: -- **00:08** : Introduction to template Studio & pointers the other parts of the docs / AP website +- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website - **03:51** : Helloworld template tutorial start -- **04:48** : Template Studio - Metadata -- **06:56** : Template Studio - Contract Text +- **04:48** : Template Playground - Metadata +- **06:56** : Template Playground - Contract Text - **07:52** : The 'live' nature of the text; how to read errors - **08:39** : Changing the template text itself - **09:17** : Changing the variables in the template text -- **10:00** : Template Studio - Model update -- **11:28** : Template Studio - Logic update +- **10:00** : Template Playground - Model update +- **11:28** : Template Playground - Logic update - **13:17** : Explanation about request types / response types -- **14:44** : Template Studio - Logic - Test Execution (request, response) +- **14:44** : Template Playground - Logic - Test Execution (request, response) - **15:57** : Test Execution - contract state - **16:49** : Test Execution - obligations - **18:20** : Wrap-up ## What next? -Learn more about authoring Accord Project templates in template studio with the [Editing a Late Delivery Clause](tutorial-latedelivery) tutorial. +Learn more about authoring Accord Project templates in Template Playground with the [Editing a Late Delivery Clause](tutorial-latedelivery) tutorial. diff --git a/website/versioned_docs/version-0.20/tutorial-hyperledger.md b/website/versioned_docs/version-0.20/tutorial-hyperledger.md index d0af680c..f8dc6805 100644 --- a/website/versioned_docs/version-0.20/tutorial-hyperledger.md +++ b/website/versioned_docs/version-0.20/tutorial-hyperledger.md @@ -57,11 +57,11 @@ Once you've provisioned your server, install all of the required tools using the - [Git](https://www.digitalocean.com/community/tutorials/how-to-install-git-on-ubuntu-18-04) - [Fabric](https://hyperledger-fabric.readthedocs.io/en/release-1.3/getting_started.html) -## Create your Smart Legal Contract with Template Studio +## Create your Smart Legal Contract with Template Playground -Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Studio](https://studio.accordproject.org/). +Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Playground](https://playground.accordproject.org/). -Template Studio is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. +Template Playground is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. This tutorial uses the `supplyagreement-perishable-goods` template. This Smart Legal Agreement combines a plaintext contract for the shipment of goods that impose conditions on temperature and humidity until the shipment is delivered. @@ -73,9 +73,9 @@ Once you've connected to your system, open https://studio.accordproject.org in a In the hosted images, Mozilla Firefox is preinstalled, click the icon on the top-left toolbar to launch it. ::: -The Template Studio allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). +The Template Playground allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). -> In the Template Studio search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. +> In the Template Playground search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. Explore the source components of the template. @@ -100,7 +100,7 @@ The _Obligations_ that are emitted by the contract are configured to be emitted Save your CTA (Cicero Template Archive) file somewhere safe, as you'll need to use it in a later step. We suggest saving the file in user's the home folder. -> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Studio. +> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Playground. For example: ```json @@ -123,7 +123,7 @@ For example: } ``` -Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Studio. +Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Playground. :::note It's important that your sample contract text exactly matches your grammar's structure, this includes trailing spaces and line breaks. To be sure that you copy everything, right click the window and choose Select All, before choosing Copy. @@ -233,7 +233,7 @@ Take a look at some of the other stateful Cicero Templates to see what changes y If you get really stuck, a solution is available for you to [download](https://drive.google.com/file/d/1cak_P_x01w8dz43aZX8N16G5DUNp6VbG/view?usp=sharing). ::: 2. Explore the source code of the Cicero chaincode shim that transforms your requests and deployments into Fabric transactions using the Fabric Node SDK. https://github.com/clauseHQ/fabric-samples/tree/master/chaincode/cicero -3. Create your own template from scratch using [Template Studio](https://studio.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). +3. Create your own template from scratch using [Template Playground](https://playground.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). ![Change Test Contract](assets/advanced/hlf4.png) > A separate tutorial for creating a template using the Cicero CLI tool can be found in [Creating a New Template](basic-create). diff --git a/website/versioned_docs/version-0.20/tutorial-latedelivery.md b/website/versioned_docs/version-0.20/tutorial-latedelivery.md index 604042a4..bc5feca8 100644 --- a/website/versioned_docs/version-0.20/tutorial-latedelivery.md +++ b/website/versioned_docs/version-0.20/tutorial-latedelivery.md @@ -4,7 +4,7 @@ title: Editing a Late Delivery Clause original_id: tutorial-latedelivery --- -This tutorial will walk you through the steps of authoring a clause template in [Template Studio](https://studio.accordproject.org/). +This tutorial will walk you through the steps of authoring a clause template in [Template Playground](https://playground.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.4.0.html) and click the "Open In Template Studio" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.4.0.html) and click the "Open In Template Playground" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.21/accordproject-faq.md b/website/versioned_docs/version-0.21/accordproject-faq.md index a792922c..b1077257 100644 --- a/website/versioned_docs/version-0.21/accordproject-faq.md +++ b/website/versioned_docs/version-0.21/accordproject-faq.md @@ -51,9 +51,9 @@ The Accord Project Community is developing several working groups focusing on di A primary purpose of the working groups is to develop a universally accessible and widely used open source library of modular, smart legal contracts, smart templates and models that reflect input from the community. Smart legal contract templates are built according to the Project’s [Cicero Specification](https://github.com/accordproject/cicero). -Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Studio](https://studio.accordproject.org/). +Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Playground](https://playground.accordproject.org/). The Accord Project has developed an easy-to-use programming language for building and executing smart legal contracts called Ergo. The goals of Ergo are to be accessible and usable by non-technical professionals, portable across, and compatible with, a variety of environments such as SaaS platforms and different blockchains, and meeting security, safety, and other requirements. -You can use the Accord Project’s [Template Studio](https://studio.accordproject.org/) to create and test your smart legal contracts. +You can use the Accord Project’s [Template Playground](https://playground.accordproject.org/) to create and test your smart legal contracts. diff --git a/website/versioned_docs/version-0.21/accordproject-template.md b/website/versioned_docs/version-0.21/accordproject-template.md index 4515718b..f579fffa 100644 --- a/website/versioned_docs/version-0.21/accordproject-template.md +++ b/website/versioned_docs/version-0.21/accordproject-template.md @@ -206,7 +206,7 @@ Let's look at each component of the template triangle, starting with the text. ### What next? -Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Studio, or by [installing Cicero](started-installation). +Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Playground, or by [installing Cicero](started-installation). Explore [sample templates](started-resources) and other resources in the rest of this documentation. diff --git a/website/versioned_docs/version-0.21/accordproject-tour.md b/website/versioned_docs/version-0.21/accordproject-tour.md index 68bfed33..5c2a41b8 100644 --- a/website/versioned_docs/version-0.21/accordproject-tour.md +++ b/website/versioned_docs/version-0.21/accordproject-tour.md @@ -4,29 +4,29 @@ title: Online Tour original_id: accordproject-tour --- -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Studio](https://studio.accordproject.org) editor. +To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. :::tip -You can open template studio from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. +You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. ::: -The following video offers a tour of Template Studio and an introduction to the key concepts behind the Accord Project technology. +The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. Here is a timestamp of what is covered in the video: -- **00:08** : Introduction to template Studio & pointers the other parts of the docs / AP website +- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website - **03:51** : Helloworld template tutorial start -- **04:48** : Template Studio - Metadata -- **06:56** : Template Studio - Contract Text +- **04:48** : Template Playground - Metadata +- **06:56** : Template Playground - Contract Text - **07:52** : The 'live' nature of the text; how to read errors - **08:39** : Changing the template text itself - **09:17** : Changing the variables in the template text -- **10:00** : Template Studio - Model update -- **11:28** : Template Studio - Logic update +- **10:00** : Template Playground - Model update +- **11:28** : Template Playground - Logic update - **13:17** : Explanation about request types / response types -- **14:44** : Template Studio - Logic - Test Execution (request, response) +- **14:44** : Template Playground - Logic - Test Execution (request, response) - **15:57** : Test Execution - contract state - **16:49** : Test Execution - obligations - **18:20** : Wrap-up diff --git a/website/versioned_docs/version-0.21/started-resources.md b/website/versioned_docs/version-0.21/started-resources.md index 51fba9de..bfd8908e 100644 --- a/website/versioned_docs/version-0.21/started-resources.md +++ b/website/versioned_docs/version-0.21/started-resources.md @@ -24,7 +24,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/website/versioned_docs/version-0.21/tutorial-studio.md b/website/versioned_docs/version-0.21/tutorial-studio.md index 082c09a9..faa21917 100644 --- a/website/versioned_docs/version-0.21/tutorial-studio.md +++ b/website/versioned_docs/version-0.21/tutorial-studio.md @@ -1,10 +1,10 @@ --- id: version-0.21-tutorial-studio -title: With Template Studio +title: With Template Playground original_id: tutorial-studio --- -This tutorial will walk you through the steps of editing a clause template in [Template Studio](https://studio.accordproject.org/). +This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.5.0.html) and click the "Open In Template Studio" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.5.0.html) and click the "Open In Template Playground" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.22/tutorial-studio.md b/website/versioned_docs/version-0.22/tutorial-studio.md index fbd57320..d9962cac 100644 --- a/website/versioned_docs/version-0.22/tutorial-studio.md +++ b/website/versioned_docs/version-0.22/tutorial-studio.md @@ -1,10 +1,10 @@ --- id: version-0.22-tutorial-studio -title: With Template Studio +title: With Template Playground original_id: tutorial-studio --- -This tutorial will walk you through the steps of editing a clause template in [Template Studio](https://studio.accordproject.org/). +This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Studio" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Playground" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.30.1/accordproject-faq.md b/website/versioned_docs/version-0.30.1/accordproject-faq.md index 8cd09c0d..6fbf9d6b 100644 --- a/website/versioned_docs/version-0.30.1/accordproject-faq.md +++ b/website/versioned_docs/version-0.30.1/accordproject-faq.md @@ -51,9 +51,9 @@ The Accord Project Community is developing several working groups focusing on di A primary purpose of the working groups is to develop a universally accessible and widely used open source library of modular, smart legal contracts, smart templates and models that reflect input from the community. Smart legal contract templates are built according to the Project’s [Cicero Specification](https://github.com/accordproject/cicero). -Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Studio](https://studio.accordproject.org/). +Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Playground](https://playground.accordproject.org/). The Accord Project has developed an easy-to-use programming language for building and executing smart legal contracts called Ergo. The goals of Ergo are to be accessible and usable by non-technical professionals, portable across, and compatible with, a variety of environments such as SaaS platforms and different blockchains, and meeting security, safety, and other requirements. -You can use the Accord Project’s [Template Studio](https://studio.accordproject.org/) to create and test your smart legal contracts. +You can use the Accord Project’s [Template Playground](https://playground.accordproject.org/) to create and test your smart legal contracts. diff --git a/website/versioned_docs/version-0.30.1/accordproject-template.md b/website/versioned_docs/version-0.30.1/accordproject-template.md index 6bfa179e..970ed3ca 100644 --- a/website/versioned_docs/version-0.30.1/accordproject-template.md +++ b/website/versioned_docs/version-0.30.1/accordproject-template.md @@ -206,7 +206,7 @@ Let's look at each component of the template triangle, starting with the text. ### What next? -Build your first smart legal contract templates, either [online](tutorial-studio.md) with Template Studio, or by [installing Cicero](started-installation.md). +Build your first smart legal contract templates, either [online](tutorial-studio.md) with Template Playground, or by [installing Cicero](started-installation.md). Explore [sample templates](started-resources.md) and other resources in the rest of this documentation. diff --git a/website/versioned_docs/version-0.30.1/started-resources.md b/website/versioned_docs/version-0.30.1/started-resources.md index 60794a02..420cb52a 100644 --- a/website/versioned_docs/version-0.30.1/started-resources.md +++ b/website/versioned_docs/version-0.30.1/started-resources.md @@ -24,7 +24,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/website/versioned_sidebars/version-0.20-sidebars.json b/website/versioned_sidebars/version-0.20-sidebars.json index 9f30ec6f..036fa587 100644 --- a/website/versioned_sidebars/version-0.20-sidebars.json +++ b/website/versioned_sidebars/version-0.20-sidebars.json @@ -15,7 +15,7 @@ "User Tutorials": [ { "type": "subcategory", - "label": "Authoring with Template Studio", + "label": "Authoring with Template Playground", "ids": [ "version-0.20-tutorial-latedelivery" ] From e02fc599ef4d2343ef6ae41e895697636d554113 Mon Sep 17 00:00:00 2001 From: anablaz Date: Tue, 5 Mar 2024 18:05:17 +0100 Subject: [PATCH 2/2] docs: remove tutorials and reverse the naming of old files back to Template Studio Signed-off-by: anablaz --- docs/accordproject-template.md | 2 +- docs/accordproject-tour.md | 32 --- docs/accordproject.md | 2 +- docs/tutorial-studio.md | 271 ------------------ website/i18n/en.json | 14 +- website/package-lock.json | 1 - .../version-0.12/accordproject-studio.md | 4 +- .../version-0.12/accordproject-tooling.md | 4 +- .../version-0.12/accordproject.md | 6 +- .../version-0.12/advanced-hyperledger.md | 16 +- .../version-0.12/advanced-latedelivery.md | 6 +- .../version-0.20/accordproject-business.md | 2 +- .../version-0.20/accordproject-concepts.md | 2 +- .../version-0.20/accordproject-developers.md | 2 +- .../version-0.20/ref-cicero-ui.md | 2 +- .../version-0.20/started-resources.md | 2 +- .../version-0.20/started-studio.md | 20 +- .../version-0.20/tutorial-hyperledger.md | 16 +- .../version-0.20/tutorial-latedelivery.md | 4 +- .../version-0.21/accordproject-faq.md | 4 +- .../version-0.21/accordproject-template.md | 2 +- .../version-0.21/accordproject-tour.md | 18 +- .../version-0.21/started-resources.md | 2 +- .../version-0.21/tutorial-studio.md | 6 +- .../version-0.22/tutorial-studio.md | 6 +- 25 files changed, 68 insertions(+), 378 deletions(-) delete mode 100644 docs/accordproject-tour.md delete mode 100644 docs/tutorial-studio.md diff --git a/docs/accordproject-template.md b/docs/accordproject-template.md index c4564fff..4c7f1285 100644 --- a/docs/accordproject-template.md +++ b/docs/accordproject-template.md @@ -205,7 +205,7 @@ Let's look at each component of the template triangle, starting with the text. ### What next? -Build your first smart legal contract templates, either [online](tutorial-studio.md) with Template Playground, or by [installing Cicero](started-installation.md). +Build your first smart legal contract templates, either [online](https://playground.accordproject.org/) with Template Playground, or by [installing Cicero](started-installation.md). Explore [sample templates](started-resources.md) and other resources in the rest of this documentation. diff --git a/docs/accordproject-tour.md b/docs/accordproject-tour.md deleted file mode 100644 index 71fb58f0..00000000 --- a/docs/accordproject-tour.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -id: accordproject-tour -title: Online Tour ---- - -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. - -:::tip -You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. -::: - -The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. - - - -Here is a timestamp of what is covered in the video: - -- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website -- **03:51** : Helloworld template tutorial start -- **04:48** : Template Playground - Metadata -- **06:56** : Template Playground - Contract Text - - **07:52** : The 'live' nature of the text; how to read errors - - **08:39** : Changing the template text itself - - **09:17** : Changing the variables in the template text -- **10:00** : Template Playground - Model update -- **11:28** : Template Playground - Logic update - - **13:17** : Explanation about request types / response types -- **14:44** : Template Playground - Logic - Test Execution (request, response) - - **15:57** : Test Execution - contract state - - **16:49** : Test Execution - obligations -- **18:20** : Wrap-up - diff --git a/docs/accordproject.md b/docs/accordproject.md index fa7e679e..4144e313 100644 --- a/docs/accordproject.md +++ b/docs/accordproject.md @@ -45,7 +45,7 @@ There is a welcoming community on Discord that is eager to help. [Join our Commu ## About this documentation -If you are new to Accord Project, you may want to first read about the notion of [Smart Legal Contracts](accordproject-slc.md) and about [Accord Project Templates](accordproject-template.md). We also recommend taking the [Online Tour](accordproject-tour.md). +If you are new to Accord Project, you may want to first read about the notion of [Smart Legal Contracts](accordproject-slc.md) and about [Accord Project Templates](accordproject-template.md). To start using Accord Project templates, follow the [Install Cicero](https://docs.accordproject.org/docs/next/started-installation.html) instructions in the _Getting Started_ Section of the documentation. diff --git a/docs/tutorial-studio.md b/docs/tutorial-studio.md deleted file mode 100644 index d801a41d..00000000 --- a/docs/tutorial-studio.md +++ /dev/null @@ -1,271 +0,0 @@ ---- -id: tutorial-studio -title: With Template Playground ---- - -This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). - -We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. - -## Initial Late Delivery Clause - -### Load the Template - -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Playground" button. - -![Advanced-Late-1](assets/advanced/late1.png) - -Begin by inspecting the `README` and `package.json` tabs within the `Metadata` section. Feel free to change the name of the template to one you like. - -### The Contract Text - -Then click on the `Text` Section on the left, which should show a `Grammar` tab, for the the natural language of the template. - -![Advanced-Late-2](assets/advanced/late2.png) - -When the text in the `Grammar` tab is in sync with the text in the `Sample` tab, this means the sample is a valid with respect to the grammar, and data is extracted, showing in `Contract Data` tab. The contract data is represented using the JSON format and contains the value of the variables declared in the contract template. For instance, the value for the `buyer` variable is `Betty Buyer`, highlighted in red: - -![Advanced-Late-3](assets/advanced/late3.png) - -Changes to the variables in the `Sample` are reflected in the `Contract Data` tab in real time, and vice versa. For instance, change `Betty Buyer` to a different name in the contract text to see the `partyId` change in the contract data. - -:::note -The JSON data `resource:org.accordproject.party.Party#Betty%20Buyer` indicate that the value is a relationship of type `Party` whose identifier is `Betty Buyer`. Consult the [Concerto Guide](model-relationships) for more details on modeling relationships. -::: - -If you edit part of the text which is not a variable in the template, this results in an error when parsing the `Sample`. The error will be shown in red in the status bar at the bottom of the page. For instance, the following image shows the parsing error obtained when changing the word `delayed` to the word `timely` in the contract text. - -![Advanced-Late-4](assets/advanced/late4.png) - -This is because the `Sample` relies on the `Grammar` text as a source of truth. This mechanism ensures that the actual contract always reflects the template, and remains faithful to the original legal text. You can, however, edit the `Grammar` itself to change the legal text. - -Revert your changes, changing the word `timely` back to the original word `delayed` and the parsing error will disappear. - -### The Model - -Moving along to the `Model` section, you will find the data model for the template variables (the `MiniLateDeliveryClause` type), as well as for the requests (the `LateRequest` type) and response (the `LateResponse` type) for the late delivery and penalty clause. - -![Advanced-Late-5](assets/advanced/late5.png) - -Note that a `namespace` is declared at the beginning of the file for the model, and that several existing models are being imported (using e.g., `import org.accordproject.contract.*`). Those imports are needed to access the definition for several types used in the model: -- `Clause` which is a generic type for all Accord Project clause templates, and is defined in the `org.accordproject.contract` namespace; -- `Party` which is a generic type for all Accord Project parties, and is defined in the `org.accordproject.party` namespace; -- `Request` and `Response` which are generic types for responses and requests, and are defined in the `org.accordproject.runtime` namespace; -- `Duration` which is defined in the `org.accordproject.time` namespace. - -### The Logic - -The final part of the template is the `Ergo` tab of the `Logic` section, which describes the business logic. - -![Advanced-Late-6](assets/advanced/late6.png) - -Thanks to the `namespace` at the beginning of this file, the Ergo engine can know the definition for the `MiniLateDeliveryClause`, as well as the `LateRequest`, and `LateResponse` types defined in the `Model` tab. - -To test the template execution, go to the `Request` tab in the `Logic` section. It should be already populated with a valid request. Press the `Trigger` button to trigger the clause. - -![Advanced-Late-7](assets/advanced/late7.png) - -Since the value of the `deliveredAt` parameter in the request is after the value of the `agreedDelivery` parameter in the request, this should return a new response which includes the calculated penalty. - -Changing the date for the `deliveredAt` parameter in the request and triggering the contract again will result in a different penalty. - -![Advanced-Late-8](assets/advanced/late8.png) - -Note that the clause will return an error if it is called for a timely delivery. - -![Advanced-Late-9](assets/advanced/late9.png) - -## Add a Penalty Cap - -We can now start building a more advanced clause. Let us first take a moment to notice that there is no limitation to the penalty resulting from a late delivery. Trigger the contract using the following request in the `Request` tab in `Logic`: -```json -{ - "$class": "org.accordproject.minilatedeliveryandpenalty.LateRequest", - "agreedDelivery": "2019-04-10T12:00:00-05:00", - "deliveredAt": "2019-04-20T03:24:00-05:00", - "goodsValue": 200 -} -``` -The penalty should be rather low. Now send this other request: -```json -{ - "$class": "org.accordproject.minilatedeliveryandpenalty.LateRequest", - "agreedDelivery": "2005-04-01T12:00:00-05:00", - "deliveredAt": "2019-04-20T03:24:00-05:00", - "goodsValue": 200 -} -``` -Notice that the penalty is now quite a large value. It is not unusual to cap a penalty to a maximum amount. Let us now look at how to change the template to add such a cap based on a percentage of the total value of the delivered goods. - -### Update the Legal Text - -To implement this, we first go to the `Grammar` tab in the `Text` section and add a sentence indicating: `The total amount of penalty shall not, however, exceed {{capPercentage}}% of the total value of the delayed goods.` - -For convenience, you can copy-paste the new template text from here: -```tem -Late Delivery and Penalty. - -In case of delayed delivery of Goods, {{seller}} shall pay to -{{buyer}} a penalty amounting to {{penaltyPercentage}}% of the total -value of the Goods for every {{penaltyDuration}} of delay. The total -amount of penalty shall not, however, exceed {{capPercentage}}% of the -total value of the delayed goods. If the delay is more than -{{maximumDelay}}, the Buyer is entitled to terminate this Contract. - -``` -This should immediately result in an error when parsing the contract text: - -![Advanced-Late-10](assets/advanced/late10.png) - -As explained in the error message, this is because the new template text uses a variable `capPercentage` which has not been declared in the model. - -### Update the Model - -To define this new variable, go to the `Model` tab, and change the `MiniLateDeliveryClause` type to include `o Double capPercentage`. - -![Advanced-Late-11](assets/advanced/late11.png) - -For convenience, you can copy-paste the new `MiniLateDeliveryClause` type from here: -```ergo -asset MiniLateDeliveryClause extends Clause { - --> Party buyer // Party to the contract (buyer) - --> Party seller // Party to the contract (seller) - o Duration penaltyDuration // Length of time resulting in penalty - o Double penaltyPercentage // Penalty percentage - o Double capPercentage // Maximum penalty percentage - o Duration maximumDelay // Maximum delay before termination -} -``` - -This results in a new error, this time on the sample contract: - -![Advanced-Late-12](assets/advanced/late12.png) - -To fix it, we need to add that same line we added to the template, replacing the `capPercentage` by a value in the `Test Contract`: `The total amount of penalty shall not, however, exceed 52% of the total value of the delayed goods.` - -For convenience, you can copy-paste the new test contract from here: -```md -Late Delivery and Penalty. - -In case of delayed delivery of Goods, "Steve Seller" shall pay to -"Betty Buyer" a penalty amounting to 10.5% of the total -value of the Goods for every 2 days of delay. The total -amount of penalty shall not, however, exceed 52% of the -total value of the delayed goods. If the delay is more than -15 days, the Buyer is entitled to terminate this Contract. - -``` - -Great, now the edited template should have no more errors, and the contract data should now include the value for the new `capPercentage` variable. - -![Advanced-Late-13](assets/advanced/late13.png) - -Note that the `Current Template` Tab indicates that the template has been changed. - -### Update the Logic - -At this point, executing the logic will still result in large penalties. This is because the logic does not take advantage of the new `capPercentage` variable. Edit the `logic.ergo` code to do so. After step `// 2. Penalty formula` in the logic, apply the penalty cap by adding some logic as follows: -```ergo - // 3. Capped Penalty - let cap = contract.capPercentage / 100.0 * request.goodsValue; - - let cappedPenalty = - if penalty > cap - then cap - else penalty; - -``` -Do not forget to also change the value of the penalty in the returned `LateResponse` to use the new variable `cappedPenalty`: -```ergo - // 5. Return the response - return LateResponse{ - penalty: cappedPenalty, - buyerMayTerminate: termination - } -``` -The logic should now look as follows: - -![Advanced-Late-14](assets/advanced/late14.png) - -### Run the new Logic - -As a final test of the new template, you should try again to run the contract with a long delay in delivery. This should now result in a much smaller penalty, which is capped to 52% of the total value of the goods, or 104 USD. - -![Advanced-Late-15](assets/advanced/late15.png) - -:::tip -A full version of the template after those changes have been applied can be found as the [Mini Late Delivery And Penalty Capped](https://templates.accordproject.org/minilatedeliveryandpenalty-capped@0.6.0.html) in the Template Library. -::: - -## Emit a Payment Obligation. - -As a final extension to this template, we can modify it to emit a Payment Obligation. This first requires us to switch from a Clause template to a Contract template. - -### Switch to a Contract Template - -The first place to change is in the metadata for the template. This can be done easily with the `full contract` button in the `Current Template` tab. This will immediately result in an error indicating that the model does not contain an `Contract` type. - -![Advanced-Late-16](assets/advanced/late16.png) - -### Update the Model - -To fix this, change the model to reflect that we are now editing a contract template, and change the type `AccordClause` to `AccordContract` in the type definition for the template variables: -```ergo -asset MiniLateDeliveryContract extends Contract { - --> Party buyer // Party to the contract (buyer) - --> Party seller // Party to the contract (seller) - o Duration penaltyDuration // Length of time resulting in penalty - o Double penaltyPercentage // Penalty percentage - o Double capPercentage // Maximum penalty percentage - o Duration maximumDelay // Maximum delay before termination -} -``` - -The next error is in the logic, since it still uses the old `MiniLateDeliveryClause` type which does not exist anymore. - -### Update the Logic - -The `Logic` error that occurs here is: -```bash -Compilation error (at file lib/logic.ergo line 19 col 31). Cannot find type with name 'MiniLateDeliveryClause' -contract MiniLateDelivery over MiniLateDeliveryClause { - ^^^^^^^^^^^^^^^^^^^^^^ -``` -Update the logic to use the the new `MiniLateDeliveryContract` type instead, as follows: -```ergo -contract MiniLateDelivery over MiniLateDeliveryContract { -``` - -The template should now be without errors. - -### Add a Payment Obligation - -Our final task is to emit a `PaymentObligation` to indicate that the buyer should pay the seller in the amount of the calculated penalty. - -To do so, first import a couple of standard models: for the Cicero's [runtime model](https://models.accordproject.org/cicero/runtime.html) (which contains the definition of a `PaymentObligation`), and for the Accord Project's [money model](https://models.accordproject.org/money.html) (which contains the definition of a `MonetaryAmount`). The `import` statements at the top of your logic should look as follows: -```ergo -import org.accordproject.time.* -import org.accordproject.cicero.runtime.* -import org.accordproject.money.MonetaryAmount - -``` - -Lastly, add a new step between steps `// 4.` and `// 5.` in the logic to emit a payment obligation in USD: -```ergo - emit PaymentObligation{ - contract: contract, - promisor: some(contract.seller), - promisee: some(contract.buyer), - deadline: none, - amount: MonetaryAmount{ doubleValue: cappedPenalty, currencyCode: USD }, - description: contract.seller.partyId ++ " should pay penalty amount to " ++ contract.buyer.partyId - }; - -``` -That's it! You can observe in the `Request` tab that an `Obligation` is now being emitted. Try out adjusting values and continuing to send requests and getting responses and obligations. - -![Advanced-Late-17](assets/advanced/late17.png) - -:::tip -A full version of the template after those changes have been applied can be found as the [Mini-Late Delivery and Penalty Payment](https://templates.accordproject.org/minilatedeliveryandpenalty-payment@0.6.0.html) in the Template Library. -::: diff --git a/website/i18n/en.json b/website/i18n/en.json index 451aa8d2..9d429930 100644 --- a/website/i18n/en.json +++ b/website/i18n/en.json @@ -14,9 +14,6 @@ "accordproject-template": { "title": "Accord Project Templates" }, - "accordproject-tour": { - "title": "Online Tour" - }, "accordproject": { "title": "Overview" }, @@ -137,9 +134,6 @@ "tutorial-nodejs": { "title": "With Node.js" }, - "tutorial-studio": { - "title": "With Template Playground" - }, "tutorial-templates": { "title": "Templates Deep Dive" }, @@ -156,7 +150,7 @@ "title": "Learning Resources" }, "version-0.12/version-0.12-accordproject-studio": { - "title": "Template Playground" + "title": "Template Studio" }, "version-0.12/version-0.12-accordproject-templates": { "title": "Open Source Templates" @@ -171,7 +165,7 @@ "title": "Deploying on Hyperledger Fabric" }, "version-0.12/version-0.12-advanced-latedelivery": { - "title": "Authoring in Template Playground" + "title": "Authoring in Template Studio" }, "version-0.12/version-0.12-advanced-nodejs": { "title": "Working with Node.js" @@ -588,7 +582,7 @@ "title": "With Node.js" }, "version-0.21/version-0.21-tutorial-studio": { - "title": "With Template Playground" + "title": "With Template Studio" }, "version-0.21/version-0.21-tutorial-templates": { "title": "Templates Deep Dive" @@ -633,7 +627,7 @@ "title": "With Node.js" }, "version-0.22/version-0.22-tutorial-studio": { - "title": "With Template Playground" + "title": "With Template Studio" }, "version-0.22/version-0.22-tutorial-templates": { "title": "Templates Deep Dive" diff --git a/website/package-lock.json b/website/package-lock.json index 109007cb..9317a711 100644 --- a/website/package-lock.json +++ b/website/package-lock.json @@ -4,7 +4,6 @@ "requires": true, "packages": { "": { - "name": "website", "license": "Apache-2.0", "dependencies": { "axios": "^0.21.2", diff --git a/website/versioned_docs/version-0.12/accordproject-studio.md b/website/versioned_docs/version-0.12/accordproject-studio.md index 12fdc5ef..5cdbbe6d 100644 --- a/website/versioned_docs/version-0.12/accordproject-studio.md +++ b/website/versioned_docs/version-0.12/accordproject-studio.md @@ -1,9 +1,9 @@ --- id: version-0.12-accordproject-studio -title: Template Playground +title: Template Studio original_id: accordproject-studio --- -[Template Playground](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project. +[Template Studio](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project. ![Model Repository](/img/studio.png) diff --git a/website/versioned_docs/version-0.12/accordproject-tooling.md b/website/versioned_docs/version-0.12/accordproject-tooling.md index 3b3633c7..be961aff 100644 --- a/website/versioned_docs/version-0.12/accordproject-tooling.md +++ b/website/versioned_docs/version-0.12/accordproject-tooling.md @@ -29,8 +29,8 @@ A simple VIM mode for Ergo can be found in the [ergo.vim](https://github.com/acc > Those are not maintained as actively as the rest of the Accord Project. If you know emacs lisp or are a VIM user and would like to contribute, please contact us on the Accord Project Slack or directly through GitHub! -## Template Playground +## Template Studio -Finally, [Template Playground](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project directly from your browser, without having to install anything. +Finally, [Template Studio](https://studio.accordproject.org) lets you create, edit and test legal clause or contract templates built with the Accord Project directly from your browser, without having to install anything. ![Model Repository](/img/studio.png) diff --git a/website/versioned_docs/version-0.12/accordproject.md b/website/versioned_docs/version-0.12/accordproject.md index 8f1f903c..a85a3545 100644 --- a/website/versioned_docs/version-0.12/accordproject.md +++ b/website/versioned_docs/version-0.12/accordproject.md @@ -67,7 +67,7 @@ Beyond a core technology for executable legal templates, Accord Project is build Several tools are also available to facilitate authoring of Accord Project templates: -- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) ## Open Source Community @@ -78,9 +78,9 @@ Join the Accord Project Technology Working Group diff --git a/website/versioned_docs/version-0.12/advanced-hyperledger.md b/website/versioned_docs/version-0.12/advanced-hyperledger.md index 6186cbd9..c8fc8583 100644 --- a/website/versioned_docs/version-0.12/advanced-hyperledger.md +++ b/website/versioned_docs/version-0.12/advanced-hyperledger.md @@ -57,11 +57,11 @@ Once you've provisioned your server, install all of the required tools using the - [Git](https://www.digitalocean.com/community/tutorials/how-to-install-git-on-ubuntu-18-04) - [Fabric](https://hyperledger-fabric.readthedocs.io/en/release-1.3/getting_started.html) -## Create your Smart Legal Contract with Template Playground +## Create your Smart Legal Contract with Template Studio -Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Playground](https://playground.accordproject.org/). +Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Studio](https://studio.accordproject.org/). -Template Playground is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. +Template Studio is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. This tutorial uses the `supplyagreement-perishable-goods` template. This Smart Legal Agreement combines a plaintext contract for the shipment of goods that impose conditions on temperature and humidity until the shipment is delivered. @@ -73,9 +73,9 @@ Once you've connected to your system, open https://studio.accordproject.org in a In the hosted images, Mozilla Firefox is preinstalled, click the icon on the top-left toolbar to launch it. ::: -The Template Playground allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). +The Template Studio allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). -> In the Template Playground search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. +> In the Template Studio search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. Explore the source components of the template. @@ -100,7 +100,7 @@ The _Obligations_ that are emitted by the contract are configured to be emitted Save your CTA (Cicero Template Archive) file somewhere safe, as you'll need to use it in a later step. We suggest saving the file in user's the home folder. -> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Playground. +> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Studio. For example: ```json @@ -123,7 +123,7 @@ For example: } ``` -Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Playground. +Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Studio. :::note It's important that your sample contract text exactly matches your grammar's structure, this includes trailing spaces and line breaks. To be sure that you copy everything, right click the window and choose Select All, before choosing Copy. @@ -233,7 +233,7 @@ Take a look at some of the other stateful Cicero Templates to see what changes y If you get really stuck, a solution is available for you to [download](https://drive.google.com/file/d/1cak_P_x01w8dz43aZX8N16G5DUNp6VbG/view?usp=sharing). ::: 2. Explore the source code of the Cicero chaincode shim that transforms your requests and deployments into Fabric transactions using the Fabric Node SDK. https://github.com/clauseHQ/fabric-samples/tree/master/chaincode/cicero -3. Create your own template from scratch using [Template Playground](https://playground.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). +3. Create your own template from scratch using [Template Studio](https://studio.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). ![Change Test Contract](assets/advanced/hlf4.png) > A separate tutorial for creating a template using the Cicero CLI tool can be found in [Creating a New Template](basic-create). diff --git a/website/versioned_docs/version-0.12/advanced-latedelivery.md b/website/versioned_docs/version-0.12/advanced-latedelivery.md index 973fcb7f..3e3099a3 100644 --- a/website/versioned_docs/version-0.12/advanced-latedelivery.md +++ b/website/versioned_docs/version-0.12/advanced-latedelivery.md @@ -1,10 +1,10 @@ --- id: version-0.12-advanced-latedelivery -title: Authoring in Template Playground +title: Authoring in Template Studio original_id: advanced-latedelivery --- -This tutorial will walk you through the steps of authoring a clause template in [Template Playground](https://playground.accordproject.org/). +This tutorial will walk you through the steps of authoring a clause template in [Template Studio](https://studio.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at https://templates.accordproject.org/minilatedeliveryandpenalty@0.2.1.html and click the "Open In Template Playground" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at https://templates.accordproject.org/minilatedeliveryandpenalty@0.2.1.html and click the "Open In Template Studio" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.20/accordproject-business.md b/website/versioned_docs/version-0.20/accordproject-business.md index c7157826..0e8469e7 100644 --- a/website/versioned_docs/version-0.20/accordproject-business.md +++ b/website/versioned_docs/version-0.20/accordproject-business.md @@ -29,4 +29,4 @@ If you are new to the Accord Project, the best place to start is our [Online Tou If any of the technical terms are confusing or hard to understand, we have a [Glossary](ref-glossary) page that may help you. If there are any concepts or terms that you want to include in the Glossary, please join our [slack channel](https://accord-project-slack-signup.herokuapp.com/) and make suggestions! -If you want to create a template yourself, please see [Authoring in Template Playground](tutorial-latedelivery) for a step-by-step guide on how to create your first template. The tutorial will provide an accessible starting point for those without significant development experience to begin building smart legal contracts using the Accord Project technology. +If you want to create a template yourself, please see [Authoring in Template Studio](tutorial-latedelivery) for a step-by-step guide on how to create your first template. The tutorial will provide an accessible starting point for those without significant development experience to begin building smart legal contracts using the Accord Project technology. diff --git a/website/versioned_docs/version-0.20/accordproject-concepts.md b/website/versioned_docs/version-0.20/accordproject-concepts.md index f6b76f6b..8c01b993 100644 --- a/website/versioned_docs/version-0.20/accordproject-concepts.md +++ b/website/versioned_docs/version-0.20/accordproject-concepts.md @@ -208,7 +208,7 @@ _More information about Ergo can be found in the [Ergo Logic](logic-ergo) Sectio ## What next? -Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Playground, or by [installing Cicero](started-installation). +Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Studio, or by [installing Cicero](started-installation). Explore [sample templates](started-resources) and other resources in the rest of this documentation. diff --git a/website/versioned_docs/version-0.20/accordproject-developers.md b/website/versioned_docs/version-0.20/accordproject-developers.md index 687ab07c..e1b191af 100644 --- a/website/versioned_docs/version-0.20/accordproject-developers.md +++ b/website/versioned_docs/version-0.20/accordproject-developers.md @@ -16,7 +16,7 @@ If this interests you, please visit our [Technology Working Group](https://www.a If you want to author, validate, and run Accord Project templates locally, please visit our [Install Cicero](https://docs.accordproject.org/docs/next/started-installation.html) page for instructions. -If you are new to the Accord Project, please read the [Key Concepts](accordproject-concepts) page. This will allow you to understand the three components of a template (text, model, and logic) and how they work together. If you want some guidance on creating your first template, please see [Authoring in Template Playground](tutorial-latedelivery) for a step-by-step guide on how to create your first template. +If you are new to the Accord Project, please read the [Key Concepts](accordproject-concepts) page. This will allow you to understand the three components of a template (text, model, and logic) and how they work together. If you want some guidance on creating your first template, please see [Authoring in Template Studio](tutorial-latedelivery) for a step-by-step guide on how to create your first template. If you want to dive into our technology stack, you can find more information about: - Software implementation: [Cicero](https://github.com/accordproject/cicero) diff --git a/website/versioned_docs/version-0.20/ref-cicero-ui.md b/website/versioned_docs/version-0.20/ref-cicero-ui.md index 30201180..21e17b26 100644 --- a/website/versioned_docs/version-0.20/ref-cicero-ui.md +++ b/website/versioned_docs/version-0.20/ref-cicero-ui.md @@ -6,7 +6,7 @@ original_id: ref-cicero-ui Accord Project publishes [React](https://reactjs.org) user interface components for use in web-applications. Please refer to the cicero-ui project [on GitHub](https://github.com/accordproject/cicero-ui) for detailed usage instructions. -You can preview these components in [Template Playground v2](https://accordproject-studio.netlify.com). +You can preview these components in [Template Studio v2](https://accordproject-studio.netlify.com). ![Template-Studio-V2](/docs/assets/reference/tsv2.png) diff --git a/website/versioned_docs/version-0.20/started-resources.md b/website/versioned_docs/version-0.20/started-resources.md index 4d4f179c..823f7a2d 100644 --- a/website/versioned_docs/version-0.20/started-resources.md +++ b/website/versioned_docs/version-0.20/started-resources.md @@ -24,7 +24,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/website/versioned_docs/version-0.20/started-studio.md b/website/versioned_docs/version-0.20/started-studio.md index e3e4c162..c56e8b8b 100644 --- a/website/versioned_docs/version-0.20/started-studio.md +++ b/website/versioned_docs/version-0.20/started-studio.md @@ -4,33 +4,33 @@ title: Online Tour original_id: started-studio --- -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. +To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Studio](https://studio.accordproject.org) editor. :::tip -You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. +You can open Template Studio from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. ::: -The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. +The following video offers a tour of Template Studio and an introduction to the key concepts behind the Accord Project technology. Here is a timestamp of what is covered in the video: -- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website +- **00:08** : Introduction to Template Studio & pointers the other parts of the docs / AP website - **03:51** : Helloworld template tutorial start -- **04:48** : Template Playground - Metadata -- **06:56** : Template Playground - Contract Text +- **04:48** : Template Studio - Metadata +- **06:56** : Template Studio - Contract Text - **07:52** : The 'live' nature of the text; how to read errors - **08:39** : Changing the template text itself - **09:17** : Changing the variables in the template text -- **10:00** : Template Playground - Model update -- **11:28** : Template Playground - Logic update +- **10:00** : Template Studio - Model update +- **11:28** : Template Studio - Logic update - **13:17** : Explanation about request types / response types -- **14:44** : Template Playground - Logic - Test Execution (request, response) +- **14:44** : Template Studio - Logic - Test Execution (request, response) - **15:57** : Test Execution - contract state - **16:49** : Test Execution - obligations - **18:20** : Wrap-up ## What next? -Learn more about authoring Accord Project templates in Template Playground with the [Editing a Late Delivery Clause](tutorial-latedelivery) tutorial. +Learn more about authoring Accord Project templates in Template Studio with the [Editing a Late Delivery Clause](tutorial-latedelivery) tutorial. diff --git a/website/versioned_docs/version-0.20/tutorial-hyperledger.md b/website/versioned_docs/version-0.20/tutorial-hyperledger.md index f8dc6805..d0af680c 100644 --- a/website/versioned_docs/version-0.20/tutorial-hyperledger.md +++ b/website/versioned_docs/version-0.20/tutorial-hyperledger.md @@ -57,11 +57,11 @@ Once you've provisioned your server, install all of the required tools using the - [Git](https://www.digitalocean.com/community/tutorials/how-to-install-git-on-ubuntu-18-04) - [Fabric](https://hyperledger-fabric.readthedocs.io/en/release-1.3/getting_started.html) -## Create your Smart Legal Contract with Template Playground +## Create your Smart Legal Contract with Template Studio -Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Playground](https://playground.accordproject.org/). +Cicero Templates are the magic glue that binds your clever legal words with the logic that will run on your network. In this first step, we'll create a template in [Template Studio](https://studio.accordproject.org/). -Template Playground is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. +Template Studio is a browser-based development environment for Cicero Templates. Your templates are only every stored in your browser (and are not shared with the Accord Project), so you should **Export** your work to save it for another time. This tutorial uses the `supplyagreement-perishable-goods` template. This Smart Legal Agreement combines a plaintext contract for the shipment of goods that impose conditions on temperature and humidity until the shipment is delivered. @@ -73,9 +73,9 @@ Once you've connected to your system, open https://studio.accordproject.org in a In the hosted images, Mozilla Firefox is preinstalled, click the icon on the top-left toolbar to launch it. ::: -The Template Playground allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). +The Template Studio allows you to load sample templates for smart legal agreements from the [Accord Project template library](https://templates.accordproject.org/). -> In the Template Playground search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. +> In the Template Studio search bar, type **supplyagreement-perishable-goods**. Select the 0.12.1 version. Explore the source components of the template. @@ -100,7 +100,7 @@ The _Obligations_ that are emitted by the contract are configured to be emitted Save your CTA (Cicero Template Archive) file somewhere safe, as you'll need to use it in a later step. We suggest saving the file in user's the home folder. -> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Playground. +> Create a `request.json` file with the contents of the **Request** box from the **Logic** -> **Test Execution** page in Template Studio. For example: ```json @@ -123,7 +123,7 @@ For example: } ``` -Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Playground. +Finally, create a `contract.txt` file with the contents of the Test Contract box from the Contract Text page in Template Studio. :::note It's important that your sample contract text exactly matches your grammar's structure, this includes trailing spaces and line breaks. To be sure that you copy everything, right click the window and choose Select All, before choosing Copy. @@ -233,7 +233,7 @@ Take a look at some of the other stateful Cicero Templates to see what changes y If you get really stuck, a solution is available for you to [download](https://drive.google.com/file/d/1cak_P_x01w8dz43aZX8N16G5DUNp6VbG/view?usp=sharing). ::: 2. Explore the source code of the Cicero chaincode shim that transforms your requests and deployments into Fabric transactions using the Fabric Node SDK. https://github.com/clauseHQ/fabric-samples/tree/master/chaincode/cicero -3. Create your own template from scratch using [Template Playground](https://playground.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). +3. Create your own template from scratch using [Template Studio](https://studio.accordproject.org/), or download the [VSCode plugin](https://marketplace.visualstudio.com/items?itemName=accordproject.accordproject-vscode-plugin). ![Change Test Contract](assets/advanced/hlf4.png) > A separate tutorial for creating a template using the Cicero CLI tool can be found in [Creating a New Template](basic-create). diff --git a/website/versioned_docs/version-0.20/tutorial-latedelivery.md b/website/versioned_docs/version-0.20/tutorial-latedelivery.md index bc5feca8..604042a4 100644 --- a/website/versioned_docs/version-0.20/tutorial-latedelivery.md +++ b/website/versioned_docs/version-0.20/tutorial-latedelivery.md @@ -4,7 +4,7 @@ title: Editing a Late Delivery Clause original_id: tutorial-latedelivery --- -This tutorial will walk you through the steps of authoring a clause template in [Template Playground](https://playground.accordproject.org/). +This tutorial will walk you through the steps of authoring a clause template in [Template Studio](https://studio.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.4.0.html) and click the "Open In Template Playground" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.4.0.html) and click the "Open In Template Studio" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.21/accordproject-faq.md b/website/versioned_docs/version-0.21/accordproject-faq.md index b1077257..a792922c 100644 --- a/website/versioned_docs/version-0.21/accordproject-faq.md +++ b/website/versioned_docs/version-0.21/accordproject-faq.md @@ -51,9 +51,9 @@ The Accord Project Community is developing several working groups focusing on di A primary purpose of the working groups is to develop a universally accessible and widely used open source library of modular, smart legal contracts, smart templates and models that reflect input from the community. Smart legal contract templates are built according to the Project’s [Cicero Specification](https://github.com/accordproject/cicero). -Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Playground](https://playground.accordproject.org/). +Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Studio](https://studio.accordproject.org/). The Accord Project has developed an easy-to-use programming language for building and executing smart legal contracts called Ergo. The goals of Ergo are to be accessible and usable by non-technical professionals, portable across, and compatible with, a variety of environments such as SaaS platforms and different blockchains, and meeting security, safety, and other requirements. -You can use the Accord Project’s [Template Playground](https://playground.accordproject.org/) to create and test your smart legal contracts. +You can use the Accord Project’s [Template Studio](https://studio.accordproject.org/) to create and test your smart legal contracts. diff --git a/website/versioned_docs/version-0.21/accordproject-template.md b/website/versioned_docs/version-0.21/accordproject-template.md index f579fffa..4515718b 100644 --- a/website/versioned_docs/version-0.21/accordproject-template.md +++ b/website/versioned_docs/version-0.21/accordproject-template.md @@ -206,7 +206,7 @@ Let's look at each component of the template triangle, starting with the text. ### What next? -Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Playground, or by [installing Cicero](started-installation). +Build your first smart legal contract templates, either [online](tutorial-latedelivery) with Template Studio, or by [installing Cicero](started-installation). Explore [sample templates](started-resources) and other resources in the rest of this documentation. diff --git a/website/versioned_docs/version-0.21/accordproject-tour.md b/website/versioned_docs/version-0.21/accordproject-tour.md index 5c2a41b8..3eb97534 100644 --- a/website/versioned_docs/version-0.21/accordproject-tour.md +++ b/website/versioned_docs/version-0.21/accordproject-tour.md @@ -4,29 +4,29 @@ title: Online Tour original_id: accordproject-tour --- -To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Playground](https://studio.accordproject.org) editor. +To get an better acquainted with Accord Project templates, the easiest way is through the online [Template Studio](https://studio.accordproject.org) editor. :::tip -You can open Template Playground from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. +You can open Template Studio from anywhere in this documentation by clicking the [Try Online!](https://studio.accordproject.org) button located in the top-right of the page. ::: -The following video offers a tour of Template Playground and an introduction to the key concepts behind the Accord Project technology. +The following video offers a tour of Template Studio and an introduction to the key concepts behind the Accord Project technology. Here is a timestamp of what is covered in the video: -- **00:08** : Introduction to Template Playground & pointers the other parts of the docs / AP website +- **00:08** : Introduction to Template Studio & pointers the other parts of the docs / AP website - **03:51** : Helloworld template tutorial start -- **04:48** : Template Playground - Metadata -- **06:56** : Template Playground - Contract Text +- **04:48** : Template Studio - Metadata +- **06:56** : Template Studio - Contract Text - **07:52** : The 'live' nature of the text; how to read errors - **08:39** : Changing the template text itself - **09:17** : Changing the variables in the template text -- **10:00** : Template Playground - Model update -- **11:28** : Template Playground - Logic update +- **10:00** : Template Studio - Model update +- **11:28** : Template Studio - Logic update - **13:17** : Explanation about request types / response types -- **14:44** : Template Playground - Logic - Test Execution (request, response) +- **14:44** : Template Studio - Logic - Test Execution (request, response) - **15:57** : Test Execution - contract state - **16:49** : Test Execution - obligations - **18:20** : Wrap-up diff --git a/website/versioned_docs/version-0.21/started-resources.md b/website/versioned_docs/version-0.21/started-resources.md index bfd8908e..51fba9de 100644 --- a/website/versioned_docs/version-0.21/started-resources.md +++ b/website/versioned_docs/version-0.21/started-resources.md @@ -24,7 +24,7 @@ Accord Project is also developing tools to help with authoring, testing and runn ### Editors -- [Template Playground](https://playground.accordproject.org/): a Web-based editor for Accord Project templates +- [Template Studio](https://studio.accordproject.org/): a Web-based editor for Accord Project templates - [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=accordproject.cicero-vscode-extension): an Accord Project extension to the popular [Visual Studio Code](https://visualstudio.microsoft.com/) Editor - [Emacs Mode](https://github.com/accordproject/ergo/tree/master/ergo.emacs): Emacs Major mode for Ergo (alpha) - [VIM Plugin](https://github.com/accordproject/ergo/tree/master/ergo.vim): VIM plugin for Ergo (alpha) diff --git a/website/versioned_docs/version-0.21/tutorial-studio.md b/website/versioned_docs/version-0.21/tutorial-studio.md index faa21917..082c09a9 100644 --- a/website/versioned_docs/version-0.21/tutorial-studio.md +++ b/website/versioned_docs/version-0.21/tutorial-studio.md @@ -1,10 +1,10 @@ --- id: version-0.21-tutorial-studio -title: With Template Playground +title: With Template Studio original_id: tutorial-studio --- -This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). +This tutorial will walk you through the steps of editing a clause template in [Template Studio](https://studio.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.5.0.html) and click the "Open In Template Playground" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.5.0.html) and click the "Open In Template Studio" button. ![Advanced-Late-1](assets/advanced/late1.png) diff --git a/website/versioned_docs/version-0.22/tutorial-studio.md b/website/versioned_docs/version-0.22/tutorial-studio.md index d9962cac..fbd57320 100644 --- a/website/versioned_docs/version-0.22/tutorial-studio.md +++ b/website/versioned_docs/version-0.22/tutorial-studio.md @@ -1,10 +1,10 @@ --- id: version-0.22-tutorial-studio -title: With Template Playground +title: With Template Studio original_id: tutorial-studio --- -This tutorial will walk you through the steps of editing a clause template in [Template Playground](https://playground.accordproject.org/). +This tutorial will walk you through the steps of editing a clause template in [Template Studio](https://studio.accordproject.org/). We start with a very simple _Late Penalty and Delivery_ Clause and gradually make it more complex, adding both legal text to it and the corresponding business logic in Ergo. @@ -12,7 +12,7 @@ We start with a very simple _Late Penalty and Delivery_ Clause and gradually mak ### Load the Template -To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Playground" button. +To get started, head to the `minilatedeliveryandpenalty` template in the Accord Project Template Library at [Mini Late Delivery And Penalty](https://templates.accordproject.org/minilatedeliveryandpenalty@0.6.0.html) and click the "Open In Template Studio" button. ![Advanced-Late-1](assets/advanced/late1.png)