instructions for OCL Lab

Signed-off-by: Orit Davidovich <orit.davidovich@protonmail.com>

Author: ordavidov

docs/ocl_lab.md

@@ -0,0 +1,60 @@
+<!--
+# Copyright IBM Corporation 2022
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+-->
+
+# AAAI 2023 OCL Lab Instructions
+
+Here are the installation instructions for participants of the OCL Lab.
+
+## `doframework` Installation
+
+We recommend installing `doframework` on a designated Python 3.8.0 environment. `doframework` has many dependancies that may override package versions in your current Python environment. 
+
+For example, if you're using `pyenv` in combination with `virtualenv` as your Python environment manager, you can type the following in your terminal
+```
+$ pyenv virtualenv 3.8.0 dof
+$ pyenv local dof
+```
+[Here](https://realpython.com/intro-to-pyenv/#virtual-environments-and-pyenv "pyenv and virtualenv") is a good source on `pyenv` and `virtualenv` by Logan Jones.
+
+Now that you've set up a dedicated Python environment, simply install
+```
+$ pip install doframework
+```
+Run a simple sanity check with
+```
+$ python
+>>> import doframework
+>>> exit()
+```
+The import command may take a while. Once it's finished (successfully, hopefully) you can exit.
+
+## `doframework` Clonning
+
+We will be running `doframework` Jupyter Notebooks as well as using other `doframework` material. Therefore, we'll clone a local copy of `doframework`. From your terminal, run
+
+```
+$ git clone https://github.com/IBM/doframework.git
+```
+To launch the OCL lab Jupyter Notebooks, we'll need to add `jupyter` to our new Python environment
+```
+$ pip install jupyter
+```
+Note that `jupyter` does not come with `doframework`. We want to keep `doframework` light for cloud distribution. Once we're done installing `jupyter`, let's launch the OCL Lab notebooks
+```
+$ cd doframework/notebooks
+$ jupyter notebook
+```
+Now we can begin ...