Outline diff to sphinx in context of automation level (#791)

twisted · May 7, 2024 · 332f67b · 332f67b
1 parent 79f4dc9
commit 332f67b
Showing 1 changed file with 2 additions and 2 deletions.
diff --git a/docs/source/faq.rst b/docs/source/faq.rst
@@ -36,8 +36,8 @@ It also has support for `zope.interface <https://zopeinterface.readthedocs.io/en
 
 How is it different from ``sphinx-autodoc``
 -------------------------------------------
-
-``sphinx-autodoc`` can be complex and the output is sometimes overwhelming, ``pydoctor`` will generate
+``sphinx-autodoc`` operates semi-automatic rather than fully automatically. It can not generate documentation solely from Python source files; it always requires a reStructuredText file as well.
+It can also be complex and the output is sometimes overwhelming, ``pydoctor`` will generate
 one page per class, module and package, it tries to keeps it simple and present information in a efficient way with tables.
 
 Sphinx narrative documentation can seamlessly link to API documentation formatted by pydoctor.