Merge pull request #78 from didx-xyz/issue_76

Adjust Readme and explanation in the getting started notebook.

Author: wip-abramson

README.md

@@ -35,7 +35,7 @@ You should now be able to run any of the tutorials or projects within this repo.
 
 E.g for the main tutorial on the aries-basic-controller
 1. Navigate to the root directory of the tutorial
-`cd tutorials/aries-basic-controller`
+`cd tutorials/1. Learning Aries, ACA-Py and the Basic Controller`
 2. Spin up the docker-compose configuration
 `./manage start`
 3. Get the urls and tokens for the juypter notebook instances within the project
@@ -47,15 +47,26 @@ E.g for the main tutorial on the aries-basic-controller
 
 In the tutorials folder you will find a set of series of juypter notebook tutorials walking through how to use the libraries contained within this repository. Each tutorial series can be run from it's folder using `./manage start`
 
-### [SSI Basics with Hyperledger](./tutorials/aries-basic-controller)
+### [Learning Aries, ACA-Py and the Basic Controller](./tutorials/1.%20Learning%20Aries,%20ACA-Py%20and%20the%20Basic%20Controller)
 
 This series introduces Self-Sovereign Identity and provides all the information needed to get started developing with the Hyperledger SSI stack using the aries-basic-controller library we developed to provide code examples within the notebooks.
 
 **This is a great place to start!** 
 
-### [Making SSI "Real"](./tutorials/aries-stagingnet)
+### [Public Ledgers and Mobile Wallets](./tutorials/2.%20Public%20Ledgers%20and%20Mobile%20Wallets)
+
+In this series you will learn how to move your solutions from a local test network onto the publicly accessible internet by connecting to the Sovrin StagingNet. You will interact with the agents through the notebooks using a publically available mobile agent that you can download from the app store.
+
+### [Sending files](./tutorials/3.%20Attachments)
+
+In this series you will learn how to attach files and send them from Alice to Bob.
+
+### [Multi-tenancy and Mediation](./tutorials/4.%20Multitenancy)
+
+In this series you will learn mainly three things. Firstly, we show how to create wallets for Alice and Bob on the same agent. These wallets are called subwallets and are managed by a base wallet. We continue by exploring mediation of communication ([see here for more details](https://github.com/hyperledger/aries-cloudagent-python/blob/main/Mediation.md)). Lastly, the tutorial expands on these concept by introducing an external agent - external as in from an outside network. Here, we use familiar concepts from the second tutorial series. 
+
+**This configuration also gives an example of how to configure an agent to use postgres for it's wallet storage**
 
-In this series you will learn how to move your solutions from a local test network onto the publicly accessible internet by connecting to the Sovrin StagingNet.
 
 ## Libraries
 

libs/aries-basic-controller/README.md

@@ -11,6 +11,6 @@ Current version 0.2
 
 ## Tutorial
 
-Find out how to use this package by taking our [jupyter notebook tutorial series](../../tutorials/aries-basic-controller).
+Find out how to use this package by taking our [jupyter notebook tutorial series](../../tutorials/).
 
 

tutorials/2. Public Ledgers and Mobile Wallets/README.md

@@ -1,10 +1,12 @@
-# Aries StagingNet Example
+# Public ledgers and mobile wallets example
 
 This example takes you through the process of moving from a local development environment into a more realistic implementation of SSI with credential schema and definitions written to the public Sovrin StagingNet.
 
 In this example, **you** will play the role of holder using a mobile agent of your choice. The notebooks represent an issuer and a verifier, the example takes you through issuing a credential to your wallet using the issuer notebook and then presenting attributes from this credential to the verifier on a different notebook. This begins to show the power of this architecture, the individual becomes the point of interoperability between systems for data about them.
 
 ## Notebooks:
 
-* [Issuer](http://localhost:8888) - run `docker logs aries-stagingnet_issuer-notebook_1` for the token.
-* [Verifier](http://localhost:8889) - run `docker logs aries-stagingnet_verifier-notebook_1` for the token.
+* [Issuer](http://localhost:8888/lab) 
+* [Verifier](http://localhost:8889/lab)
+
+In order to obtain the tokens required to access the notebooks, please run `./scripts/get_URLS.sh` in the root folder of the project (`/PyDentity`). If you run this you can also just click the links genrated by the script instead of copy-pasting the token.

tutorials/2. Public Ledgers and Mobile Wallets/notebooks/issuer/Part 1 - Getting Started.ipynb

@@ -67,7 +67,7 @@
     "    * For a complete list of Aca-Py startup parameters please refer to [this](https://github.com/hyperledger/aries-cloudagent-python/blob/25b7a9c08921e67b0962c434102489884ac403b2/aries_cloudagent/config/argparse.py) link.\n",
     "* Ensure that agent is exposed to the internet with `ngrok`\n",
     "\n",
-    "Both of these are already taken care off by the `example/aries-stagingnet` docker environment.\n"
+    "Both of these are already taken care off by the aries-args YAML files in the configuration folder in PyDentity root that provide paramaeters for the docker environments. You can go and have a look in the docker-compose.yml in this tutorial folder to see what images are used. Then check the respective docker and arg files to get an idea of how this can be configured.\n"
    ]
   },
   {
@@ -111,4 +111,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 4
-}
+}