Prefix TL;DR Stop publishing changes to in tree documentation for the master branch to http://docs.openstack.org/developer/project, then only release documentation will be published. Also, have http://docs.openstack.org/developer/project contain the latest released changes (or redirect to them).
The IRC log below contains the thought process and justification for this change.
bcwaldon | mtaylor: I think its more valuable to see what matches latest pypi release
+mtaylor | bcwaldon: and have a master dir
+mtaylor | ?
bcwaldon | sure
+mtaylor | bcwaldon: or skip publishing master docs at all?
bcwaldon | mtaylor: master might not be useful
+mtaylor | ok
bcwaldon | mtaylor: since you cant get the client that matchthose docs without installing from source
+mtaylor | clarkb: ^^^
bcwaldon | mtaylor: pypi/packages are our main distro method here
+mtaylor | bcwaldon: +
+mtaylor | bcwaldon: ++
+mtaylor | good point, and I believe I agree with you
bcwaldon | excellent
bcwaldon | also, check out latest python-glanceclient docs
clarkb | ok, I need to run now, but will reconfigure the jobs so that only publishing actually pushes doc changes
bcwaldon | clarkb: thanks!
+mtaylor | clarkb: we should probably also think about how to have the most recent thing that was published to root get moved to its tag when a new tag is made
+mtaylor | bcwaldon: NICE
bcwaldon | mtaylor: why thank you, I think thats infinitely more useful
bcwaldon | mtaylor: and i'm super excited about the release notes section
+mtaylor | bcwaldon: yes. it's a thing about which one should be excited!
clarkb | mtaylor a redirect in /index.html should work
Are we talking about just client, or client and server projects?