From e11db82dd96b49fdb56ec963cde4a2feba12f29d Mon Sep 17 00:00:00 2001
From: davidmezzetti <561939+davidmezzetti@users.noreply.github.com>
Date: Mon, 16 Aug 2021 12:53:24 -0400
Subject: [PATCH] Documentation updates

---
 README.md       | 10 +++++-----
 docs/install.md | 16 +++++++++++-----
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 187ee68a..67c3e17b 100644
--- a/README.md
+++ b/README.md
@@ -59,12 +59,12 @@ The easiest way to install is via pip and PyPI
 
     pip install txtai
 
-You can also install txtai directly from GitHub. Using a Python Virtual Environment is recommended.
+Python 3.6+ is supported. Using a Python [virtual environment](https://docs.python.org/3/library/venv.html) is recommended.
 
-    pip install git+https://github.com/neuml/txtai
-
-Python 3.6+ is supported. See the detailed [install instructions](https://neuml.github.io/txtai/install) for more information covering optional
-dependencies and environment specific prerequisites.
+See the detailed [install instructions](https://neuml.github.io/txtai/install) for more information covering
+[installing from source](https://neuml.github.io/txtai/install/#install-from-source),
+[environment specific prerequisites](https://neuml.github.io/txtai/install/#environment-specific-prerequisites) and
+[optional dependencies](https://neuml.github.io/txtai/install/#optional-dependencies).
 
 ## Examples
 
diff --git a/docs/install.md b/docs/install.md
index f5fca6dd..8a12458c 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -4,21 +4,27 @@ The easiest way to install is via pip and PyPI
 
     pip install txtai
 
-You can also install txtai directly from GitHub. Using a Python Virtual Environment is recommended.
+Python 3.6+ is supported. Using a Python [virtual environment](https://docs.python.org/3/library/venv.html) is recommended.
+
+## Install from source
+
+txtai can also be installed directly from GitHub to access the latest, unreleased features.
 
     pip install git+https://github.com/neuml/txtai
 
-Python 3.6+ is supported. Additional environment specific prerequisites are below.
+## Environment specific prerequisites
 
-## Linux
+Additional environment specific prerequisites are below.
+
+### Linux
 
 Optional audio transcription requires a [system library to be installed](https://github.com/bastibe/python-soundfile#installation)
 
-## macOS
+### macOS
 
 Run `brew install libomp` see [this link](https://github.com/kyamagu/faiss-wheels#prerequisite)
 
-## Windows
+### Windows
 
 Optional dependencies require [C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)