Small improvements to test instructions (#192)

Author: jparismorgan

README.md

@@ -40,16 +40,4 @@ We welcome contributions. Please see [`Building`](./documentation/Building.md) f
 development-build instructions. For large new
 features, please open an issue to discuss goals and approach in order
 to ensure a smooth PR integration and review process. All contributions
-must be licensed under the repository's [MIT License](./LICENSE).
-
-# Testing
-
-* Unit tests: `pytest`
-* Demo notebooks:
-  * ```
-    pip install -r test/ipynb/requirements.txt
-    pytest --nbmake test/ipynb
-    ```
-* Credentials:
-  * Some tests run on TileDB Cloud using your current environment variable `TILEDB_REST_TOKEN` -- you will need a valid API token for the tests to pass 
-  * For continuous integration, the token is configured for the `unittest` user and all tests should pass
+must be licensed under the repository's [MIT License](./LICENSE).

documentation/Building.md

@@ -8,10 +8,38 @@ pip install git+https://github.com/TileDB-Inc/TileDB-Vector-Search.git#subdirect
 ```
 
 ## Installation from a local checkout:
-```
+```bash
 cd apis/python
 pip install .
 ```
+
+# Testing
+
+You can run unit tests with `pytest`. You'll also need to install the test dependencies:
+```bash
+cd apis/python
+pip install ".[test]"
+```
+Then you can run the tests:
+```bash
+cd apis/python
+# To run all tests.
+pytest
+# To run a single test and display standard output and standard error.
+pytest test/test_ingestion.py -s
+```
+
+To test Demo notebooks:
+```bash
+cd apis/python
+pip install -r test/ipynb/requirements.txt
+pytest --nbmake test/ipynb
+```
+
+Credentials:
+* Some tests run on TileDB Cloud using your current environment variable `TILEDB_REST_TOKEN` - you will need a valid API token for the tests to pass. See [Create API Tokens](https://docs.tiledb.com/cloud/how-to/account/create-api-tokens) for for instructions on getting one.
+* For continuous integration, the token is configured for the `unittest` user and all tests should pass.
+
 # Dependencies
 
 ## Linux
@@ -22,7 +50,7 @@ apt-get openblas-dev build-essentials cmake3
 ```
 
 To build the python API after you have the dependencies, use pip:
-```
+```bash
 cd apis/python
 pip install .
 ```