I managed to read documentation finally. I made a fork of Twisted repository using these commands:

git clone https://github.com/<yourusername>/twisted.git Twisted
cd Twisted
git remote add upstream https://github.com/twisted/twisted.git
git fetch upstream
git branch -u upstream/trunk trunk

Then created python virtualenv and installed Sphinx into it. Then I tried to generate narrative HTML documentation:

(twisted-dev-env) pi@zyuzino11:~/ColourDreams/Twisted-dev $ cd docs

(twisted-dev-env) pi@zyuzino11:~/ColourDreams/Twisted-dev/docs $ make html

sphinx-build -b html -d _build/doctrees . _build/html

Running Sphinx v1.5.3

Exception occurred:

File "conf.py", line 45, in <module>

from twisted import version as twisted_version_object

ImportError: No module named twisted

The full traceback has been saved in /tmp/sphinx-err-75zxJ8.log, if you want to report the issue to the developers.

Please also report this if it was a user error, so that a better error message can be provided next time.

A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

Makefile:53: ошибка выполнения рецепта для цели «html»

make: *** [html] Ошибка 1

(twisted-dev-env) pi@zyuzino11:~/ColourDreams/Twisted-dev/docs $

Please help me to resolve this error!

Kind regards, Roman Mescheryakov

03.03.2017, 15:25, "Jean-Paul Calderone" <exarkun@twistedmatrix.com>:

On Fri, Mar 3, 2017 at 2:57 AM, Роман Мещеряков <romanmescheryakov@yandex.ru> wrote:

Hi everyone,

On the documentation web page https://twistedmatrix.com/documents/current/core/howto/application.html in the “Customizing twistd logging” section there are 2 examples which as I can see are a bit outdated in terms of imported module names and some other minor details. I would like to fix that. Is this change is worth doing? If so, please guide how can I do it. My GitHub login, if it’s needed, is RomanMeR.

Hi Роман,

Thanks for your interest in improving Twisted! Have a look at https://twistedmatrix.com/trac/wiki/TwistedDevelopment and then let us know if you have further questions.

Jean-Paul