Pub/Sub Releases Page for Google Cloud Client Library for Python Needs An Update

[anguillanneuf]

The latest release for Pub/Sub is 0.37.2. But the releases page is somewhat behind at 0.30.0.

Could we update this page? https://google-cloud-python.readthedocs.io/en/stable/pubsub/releases.html

[tseaver]

The stable tree in the docs should be removed altogether: it is completely pointless / bogus now that we have deprecated the umbrella package, and is not being updated.

[tseaver]

@theacodes I tried to poke into this, but couldn't figure out how the contents of the stable/ tree are being populated: test_utils/scripts/update_docs.sh doesn't touch that tree at all.

$ git checkout  gh-pages
Branch gh-pages set up to track remote branch gh-pages from upstream.
Switched to a new branch 'gh-pages'
$ cd stable
$ git log .
commit ec7539ebf717f06f65860b7652031f5a91469741
Author: Christopher Wilcox <git@crwilcox.com>
Date:   Mon Apr 23 16:49:18 2018 -0700

    Redirect all pages of GitHub.io site to RTD (#5225)
    
    * generate redirect md for each file in github pages
    add config file that makes redirects work using jekyll plugin
    
    * delete versions not on RTD
    
    * mirror latest to stable

commit db32b916b3e36242dd1561a81131391dadf65ccd
Author: Danny Hermes <daniel.j.hermes@gmail.com>
Date:   Wed Dec 20 09:59:08 2017 -0800

    Removing `stable/` docs from `gh-pages`. (#4637)
    
    Done via:
    
      $ git rm -fr stable/
    
    Fixes #4611.

So, it looks like @crwilcox repopulated the stable/ branch in #5225 after @dhermes removed it in #4637. Becuase stable/ is worthless, I'd rather re-remove it and then fix up any links which still point to it.

[theacodes]

Sounds reasonable to me?

[tseaver]

@theacodes Should the version trees for gcloud stay under gh-pages, e,g the 0.10.0 version. OTOH, all the _modules bits under gh-pages:0.10.0 are broken.

[theacodes]

If the docs are broken, we should drop them.

…

On Mon, Sep 10, 2018 at 1:06 PM Tres Seaver ***@***.***> wrote: @theacodes <https://github.com/theacodes> Should the version trees for gcloud stay under gh-pages, e,g the 0.10.0 version <https://google-cloud-python.readthedocs.io/en/0.10.0/>. OTOH, all the _modules bits under gh-pages:0.10.0 are broken. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#5894 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAPUczWj6TtUwi7hGEdJkHE8hLN7hyUBks5uZsZdgaJpZM4Wdgkr> .

[tseaver]

I don't even know what the _modules bits are for. (/me looks). Hmm, seems to be pages generated for source code.

[theacodes]

hrm that's probably not very important then.

…

On Mon, Sep 10, 2018 at 1:16 PM Tres Seaver ***@***.***> wrote: I don't even know what the _modules bits are for. (/me looks). Hmm, seems to be pages generated for source code. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#5894 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAPUc5Ybzv1Kq17bBEHIacs8FvqCpLj5ks5uZsi2gaJpZM4Wdgkr> .

[tseaver]

So, on the gh-pages branch, should I:

• git rm -r stable/ 0.*/
• Or just leave them as they are.

In addition, should we tweak the RTD config to drop the version-specific and stable builds? BTW, if you'd like to add me as a maintainer / owner there, I can poke at it.

[theacodes]

readthedocs is basically dead for us.

…

On Tue, Sep 11, 2018 at 10:42 AM Tres Seaver ***@***.***> wrote: So, on the gh-pages branch, should I: - git rm -r stable/ 0.*/ - Or just leave them as they are. In addition, should we tweak the RTD config to drop the version-specific and stable builds? BTW, if you'd like to add me as a maintainer / owner there, I can poke at it. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#5894 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAPUc_KPl7CwTGs54t3GcEpehfl0THtZks5uZ_X_gaJpZM4Wdgkr> .

[tseaver]

But would it be, post repo-split? I have a suspicion, for instance, that the ginormous docs/bigquery/generated bit (from autosummary) may be killing the RTD build.