Update readthedocs page

[fehiepsi]

No description provided.

[fehiepsi]

@fritzo Do you have a config file for black? I run make format but it causes a lot of changes.

[fritzo]

Our only config file is setup.cfg but we do not configure black. Maybe you need to update isort, whose black support was added only in 5.0?

pip install -U isort black flake8

[fehiepsi]

I just updated the packages. I am not sure what is the default behavior but it seems to me the changes here look more consistent with what I think black will do. For example,

        params = {
            "eps_g": {},
            "eps_i": {},
        }

should be in 1 line

params = {"eps_g": {}, "eps_i": {}}

if it fits into an 88-length (black default line length) line. Anyway, I will revert the changes to not populate this PR, whose current changes might be caused by some mysterious config files in my system.

[fritzo]

Hmm that's weird. I especially don't understand why linting (black --check .) passed both before and after your black changes e7dc9d1 Does make lint pass on your system?

[fehiepsi]

Yeah, you are right. black --check . passed now, and make format does not change files anymore. It is weird... I guess black supports two formatting rules for parentheses and based on "cache" or something like that, black will behave differently... Anyway, I will revert unrelated changes because make format seems to work now in my system.

a side note: the current behavior is a bit different from what I understand from How black wraps lines.

update2: yeah, there seems to have two acceptable behaviors for black (also the related issue on how black deals with trailing commas on list/tuple/dict/...). Hopefully, there will be a flag in the next black release, that makes the behavior consistent.

[fehiepsi]

@fritzo There are a few black changes remaining, hope that they are fine. I have incorporated (and tested) the following changes that I made to rtd page:

• add the ability to add examples/tutorials to index.rst file
• add the ability to generate thumbnail galleries (this is not necessary)
• add colab links to rendered tutorials
• each tutorial/example has a link that points to the source file (with correct version) in github.

I need to add __version__ to funsor.__init__.py to generate correct links for local versions (not sure if it is needed for funsor.pyro.ai). We expose __version__ in pyro and numpyro so it is fine to do it here I guess.

[fritzo]

Thanks @fehiepsi, this is great!