kernc

I don't know whether it's a problem. You should use a [main guard](https://stackoverflow.com/questions/19578308/what-is-the-benefit-of-using-main-method-in-python) for runnable code. > ``` > In [4]: mod = pdoc.Module('/home/lucas/gen_config/get_config.py') > /home/lucas/gen_config/config/out.cfg > > SystemExit: 0...

_Docs hierarchy follows module hierarchy_ is one of the imperatives. With `pdoc ... get_config.py` you're only telling it to document the one module. Point it at the parent package/directory to...

The first "error message" is just a warning; CPython issue [bpo27578](https://bugs.python.org/issue27578), PR https://github.com/python/cpython/pull/20809 (please upvote). `__pdoc__ = {'tests': False}` _inside_ `mwe.tests` is obviously wrong (results in the path `mwe.tests.tests`). But...

So the solution is to include a `.nojekyll` file at the document root.

No hurry, but this would sure make a nice addition! :smiley:

Since you seem to have already investigated it some, care to propose a fix here: https://github.com/pdoc3/pdoc/blob/2cce30a9b55eeeddc1ed826c8a2ada53777c3eea/pdoc/__init__.py#L196-L235 or here: https://github.com/pdoc3/pdoc/blob/2cce30a9b55eeeddc1ed826c8a2ada53777c3eea/pdoc/__init__.py#L719-L768 ?

It looks like something in `iter_modules()`. `inspect.getmodulename(file)` recognizes those .so files as valid modules, so the function offers them for importing ... :thinking:

I'd rather something more strict like: ```py if '.cpython-' in module_name: continue ``` PR welcome. I see with `--skip-errors` CLI switch, one can already turn this into a warning. https://github.com/pdoc3/pdoc/blob/2cce30a9b55eeeddc1ed826c8a2ada53777c3eea/pdoc/__init__.py#L753-L761

Can you show example of an error with `abcd.so` file?

I don't see how the seemingly erroneous output can be easily remedied – the paragraph strings are too long and get [truncated to the absolute specified size](https://github.com/pdoc3/pdoc/blob/04960e41b9bb598b664a50078f4c233817326170/pdoc/html_helpers.py#L65-L68). To avoid overriding...