docs published for previous releases overwrite current developer docs

[aeva black]

Developer docs are published to: http://docs.openstack.org/developer/ironic/

Normally, these are published after every commit is merged to the openstack/ironic project, and so the developer references online stay current. We are in the Mitaka cycle right now, and the latest Ironic version to be released was 4.2.x

However, the website above indicates, in the footer, that it is showing documentation for "ironic 2015.1.2". It seems that we just had a case where a release tag was pushed for a patch update to the previous stable/kilo release, and the doc publish job overwrote the website with that 6-month-old documentation!

Here is the corresponding Jenkins job: https://jenkins06.openstack.org/view/Overview/job/ironic-docs/213/

Build #213 (Oct 13, 2015 5:50:46 PM)

Triggered by reference: refs/tags/2015.1.2
Old revision: 0000000000000000000000000000000000000000
New revision: 342196a90373e66b9aba97e85c7a92e999d99d4e
Pipeline: release

All builds for this change set:

    ironic-docs #213: SUCCESS
    ironic-merge-release-tags #5: SUCCESS
    ironic-tarball #4: SUCCESS

Reported result: SUCCESS

[aeva black (tenbrae)]

FWIW, I think we should be publishing docs for previous releases -- they should just be in a different location :)

[Ruchi Parmar (ruchiparmar143)]

Hi.
The corresponding Jenkins job link doesn't exist and the ironic version in footer already says 4.2.x

 I am new to this community. Can anybody please give me some pointers to resolve this bug.
Thank you and I really appreciate the help in advance.

[Dmitry Tantsur (divius)]

This should be brought to the docs team, I guess. Not sure what else we can do..

[Ruby Loo (rloo)]

The docs have changed since this was reported and I don't think we have this issue any more. We now have docs per release, and they have moved to https://docs.openstack.org/ironic/latest (https://docs.openstack.org/ironic/pike for pike release).