diff --git a/demo/scenarios/demo_script.txt b/demo/scenarios/demo_script.txt index 78b8a268..c016d798 100644 --- a/demo/scenarios/demo_script.txt +++ b/demo/scenarios/demo_script.txt @@ -1,5 +1,5 @@ Pre-Demo Steps: - - Execute the Requirements and Demos steps from https://mlte.readthedocs.io/en/latest/development/#quickstart. + - Execute the Requirements and Demos steps from the Setup seciton in https://mlte.readthedocs.io/en/latest/development/#quickstart. - (Optional) Install wget. - Execute all notebooks so that the results can be seen in the notebooks themselves. This can be done in VSCode, or in another program that runs Jupyter Notebooks. Be sure to run the notebooks in the virtual environment created at the beginning, so that all dependencies are installed. - Ensure that the Docker daemon is running. diff --git a/docs/docs/development.md b/docs/docs/development.md index 8d96b75a..b0342108 100644 --- a/docs/docs/development.md +++ b/docs/docs/development.md @@ -2,7 +2,9 @@ This document describes some of the development practices used within `MLTE`. -## Requirements +## Setup + +### Requirements - MLTE uses `poetry` to handle the required runtime and development packages. The first step is to install `poetry` on your system. See https://python-poetry.org/docs/#installation. - You also need to set up a virtual Python environment where poetry will work on. While inside the root of the repository, execute this command: @@ -11,9 +13,9 @@ This document describes some of the development practices used within `MLTE`. $ python -m venv .venv ``` -## Dev Environment Setup +### Dev Environment Setup -Once poetry and the virtual env are setup, you can set up dev dependencies like this: +Once poetry and the virtual env are setup, you can set up dev dependencies like this, from the root of the repository: ```bash $ poetry install --with qa,test,build,docs @@ -21,9 +23,9 @@ $ poetry install --with qa,test,build,docs Now you are ready to start working on `MLTE`! -## Demos +### Demos -There are several demos available in the `demo\` folder, as Jupyter notebooks. To run them, you need to install their dependencies first. This can be done with: +There are several demos available in the `demo\` folder, as Jupyter notebooks. To run them, you need to install their dependencies first. This can be done from the root of the repository with: ```bash $ poetry install --with demo