title bar of docs displays incorrect version

[johnomotani]

What happened:
The browser title bar displays an incorrect version when viewing the docs online. See below - title bar says 0.15.1 but actual version in URL is 0.16.0.

http://xarray.pydata.org/en/stable/ also displays 0.15.1 in the title bar, but I guess is actually showing 0.16.0 docs (?), which is confusing!

[keewis]

thanks. Yes, there either seems to be something wrong with setuptool_scm, or we indeed didn't import the correct version of xarray (the build logs report that 0.15.1 was imported). This also doesn't work for the current latest: it says 0.16.0 instead of 0.16.1.devXY+gaabbccdd.

[keewis]

actually, it seems the reason for this is #3567: by not installing, we never call setuptools_scm to set the version (it doesn't use the 999 version we use as a fallback either, though, it uses the other version installed: right now 0.16.0)

[keewis]

to fix that, we'd need to install the project using pip, but RTD uses --upgrade --upgrade-strategy eager without --no-deps which means we wouldn't be able to use version pinning. So I guess we have to wait on RTD?

[dcherian]

Thanks for tracking this down @keewis

[keewis]

they don't want to add --no-deps to the install command (see readthedocs/readthedocs.org#7345 (comment)), but we can work around that by appending

  - pip
  - pip:
    # path to the folder containing setup.py relative to the environment file
    # if I understand it correctly, this feature is only available when using editable installs
    - -e ../..

to our environment file (not sure if there's documentation about this, but there's an example file). Something similar should also work with requirements files.

I'll send in a PR.