Merge pull request #196 from antmicro/add_readme

Add basic README for documentation
This commit is contained in:
Tim Ansell 2020-04-01 09:45:44 -07:00 committed by GitHub
commit 5cf83d7bfb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 30 additions and 0 deletions

30
README.rst Normal file
View File

@ -0,0 +1,30 @@
===============
Getting Started
===============
Building documentation
----------------------
Activate the virtual environment and install dependencies::
make env
source enter-env.sh
Build the whole documentation::
make html
For more options see::
make help
Packages in virtual environment
-------------------------------
To install packages in conda environment you can use both
``conda`` and ``pip``.
Note that ``pip`` is installed in the conda environment which uses ``python3``,
and is related to ``pip3`` **inside** the virtual environment,
whereas invocation of ``pip3`` directly uses your **system** ``pip3`` instance,
typically located in ``/usr/bin/pip3``