Update documentation

[mfarina1]

Update README and the generated API Python docs

[mfarina1]

Potential updates to README:

• [x] include command: git submodule update --init --recursive for resolving certain installation errors
• [x] Add instructions for working in Python virtual environment with proper version of python
• [x] Suggest running pip3 install command as two commands

[mfarina1]

• [ ] As noted by @BrianSipos, the ACE docs don't adequately describe how it interacts with a group of ADM module files to check references and to translate enumerations, so we need to add this

[justinethier]

Worked through installation of ACE this afternoon with @mfarina1 and we identified the following procedure to set everything up:

python3 -m venv .venv
source .venv/bin/activate
pip3 install pip-tools
python3 -m piptools compile --extra test pyproject.toml
pip3 install -r requirements.txt 
pip3 install -e '.[test]'
python3 -m pytest -v --cov=ace tests

This was tested on Ubuntu 22 with Python 3.10.

[justinethier]

Also, these commands are useful to run individual unit tests and may be worth documenting for development:

pytest -v -o log_cli=true tests/test_ari_text.py
pytest -v --log-cli-level=INFO tests/test_ari_text.py -k 'test_literal_text_options'