The general problem is that the correct links *don't exist* until a release is cut, which means that a correct install guide can't be published simultaneously with the release. This has been exacerbated by us having the docs in-tree (https://github.com/openstack/swift/commit/cf8b939).
Damian, on which page? As the bug points out, the newton install-guide (at https:/ /docs.openstack .org/project- install- guide/object- storage/ newton/ controller- install- rdo.html as well as some other pages) currently includes links to mitaka sample configs.
Similarly, the ocata install guide has links to newton sample configs (as on https:/ /docs.openstack .org/project- install- guide/object- storage/ ocata/controlle r-install- rdo.html).
The Pike guide changed URL conventions (see https:/ /docs.openstack .org/swift/ pike/install/ controller- install- rdo.html), but it *also* references the wrong release; in this case ocata.
The general problem is that the correct links *don't exist* until a release is cut, which means that a correct install guide can't be published simultaneously with the release. This has been exacerbated by us having the docs in-tree (https:/ /github. com/openstack/ swift/commit/ cf8b939).