4 Commits

Author SHA1 Message Date
Ian Wienand
882b730fdf Update to openstackdocstheme
This modernises the openstack-infra documentation by switching to
openstackdocstheme.  Update dependencies as required.

To remove non-relevant stuff from conf.py, I have just taken the demo
file from openstackdocstheme and lightly modified it.

It seems later sphinx has included it's own ":file:" role which now
conflicts.  Change it it ":cgit_file:" in our documentation.  Remove
the custom header template which no longer applies.  Add the
post-2.0-pbr sphinx-based warning-as-error, which fixes the original
problem that I actually noticed that errors could slip through the
gate tests :)

Change-Id: Ic7bec57b971bb4c75fc839e7269d1f69a576b85c
2018-06-25 11:19:43 +10:00
Ian Wienand
1b8a1018fe Add some rationale for reprepro
An interesting discussion this morning brought up some details of
reprepro that maybe aren't widely understood.  Add some rationale to
the docs.

Change-Id: I371cc67a10d29881b8df03f09830776bf5639ac8
2018-05-31 08:01:47 +10:00
Ian Wienand
b8703c3f54 Add notes on reprepro _addreference
I had to figure out this command to restore some of our reprepro
mirrors, add notes on it.

Cleanup some other things I noticed; quotes around REPREPRO command,
clarify the situation with pointing mirrors at the RO/RW volumes and
refactor discussion.

Change-Id: I3e3f763929bf74e0c4faf29b13973dcf1df36975
2018-03-19 13:51:23 +11:00
Ian Wienand
3620dd24ef Add reprepo documentation
Add some documentation on reprepo, including some recovery techniques
gleaned from the battlefield.

Change-Id: I3368dedc1b9a769a1c8f5e8fe831d059ff23875b
2017-10-18 11:01:31 +11:00