5f2eb6dade
Reading through the docs for the first time, the reader encounters an instruction to provide a minimal configuration, with a link that they'd expect to tell them how to do this. At present the link actually takes them to the top of configuration.html, where they read some history about how devstack's configuration has changed over time. This is interesting and important and should be in the docs - but in my opinion a link about setting up a minimal configuration would be more useful if it takes me to a place that tells them about a minimal configuration. To get this, I've had to an an explicit link target into configuration.rst. I'm not hugely keen on this approach, as I don't think it scales well. I'd be open to suggestions about other approaches. The only idea I've had so far though is to simply move the minimal configuration section right to the top of the page, so that a link to the doc is a link to the minimal config - the historical information could be moved to its own topic somewhere further down the doc. Change-Id: I231ca1b7f17b55f09a4e058dab8ee433893f737e |
||
---|---|---|
.. | ||
assets/images | ||
guides | ||
changes.rst | ||
conf.py | ||
configuration.rst | ||
eucarc.rst | ||
exerciserc.rst | ||
faq.rst | ||
hacking.rst | ||
index.rst | ||
local.conf.rst | ||
openrc.rst | ||
overview.rst | ||
plugins.rst | ||
stackrc.rst |