pydoctor works by parsing the source code and examining the syntax trees of Python modules and packages, which has advantages and disadvantages over generating the documentation from examining live objects, as some other documentation tools do.