commit cc7b22c8f7e28db52fde2b78286e3838843c4a3b Author: Damian Johnson atagar@torproject.org Date: Fri Oct 23 18:10:38 2020 -0700

Update website build instructions

Building now requires the typehint plugin. Noting that and the pip command to install it and sphinx. --- docs/faq.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/docs/faq.rst b/docs/faq.rst index 7df2dd51..765d864b 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -6,6 +6,7 @@ Frequently Asked Questions * :ref:`what_is_stem` * :ref:`does_stem_have_any_dependencies` * :ref:`what_python_versions_is_stem_compatible_with` + * :ref:`how_do_i_validate_the_pgp_signature` * :ref:`can_i_interact_with_tors_controller_interface_directly` * :ref:`are_there_any_other_controller_libraries` * :ref:`what_license_is_stem_under` @@ -587,7 +588,7 @@ To start hacking on Stem please do the following and don't hesitate to let me know if you get stuck or would like to discuss anything!

#. Clone our `git http://git-scm.com/`_ repository: **git clone https://git.torproject.org/stem.git** -#. Get our test dependencies: **sudo pip install mock pycodestyle pyflakes mypy**. +#. Get our test dependencies: **sudo pip install mock pyflakes pycodestyle mypy**. #. Find a `bug or feature https://github.com/torproject/stem/issues/`_ that sounds interesting. #. When you have something that you would like to contribute back do the following...

@@ -639,9 +640,9 @@ See ``run_tests.py --help`` for more usage information. How can I test compatibility with multiple python versions? -----------------------------------------------------------

-Stem supports python versions 2.6 and above, including the 3.x series. You can -test all versions of python you currently have installed on your system with -`tox https://testrun.org/tox/`_. If you're using a Debian based system this +Stem supports python versions 3.6 and above. You can test all versions of +python you currently have installed on your system with `tox +https://testrun.org/tox/`_. If you're using a Debian based system this can be as simple as...

:: @@ -682,8 +683,14 @@ example... How do I build the site? ------------------------

-If you have `Sphinx http://sphinx-doc.org/`_ version 1.3 or later installed -then building our site is as easy as... +To build Stem's website install `Sphinx http://sphinx-doc.org/`_ with its +`typehint plugin https://github.com/agronholm/sphinx-autodoc-typehints`_... + +:: + + ~$ sudo pip install sphinx sphinx-autodoc-typehints + +Then simply run **make html** within our **docs** directory...

::