Stephen Finucane

I wasn't running these, I was running the https://github.com/kubernetes/cloud-provider-openstack e2e tests. I wrote a very high level doc on running there, which you can see at https://github.com/kubernetes/cloud-provider-openstack/pull/2006. Unfortunately I couldn't...

@ikalnytskyi Would you be open to granting the relevant permissions to either @fcollonval or I?

Would you be able to open a PR with the relevant fixes first? If @ikalnytskyi isn't available, we'll also need to reach out to the PyPI team to request access...

@cdeil The best way to approach this is with a PR. I'm pretty sure I borrowed the layout from *click-contrib's* brethren, *sphinxcontrib-autoprogram*. Ideally, I'd like to make this configurable. Perhaps...

No. As noted above, we'd need a PR to work on this

[We use](https://github.com/click-contrib/sphinx-click/blob/1.0.3/sphinx_click/ext.py#L90) the built-in `option`, `program` and `envvar` directives [provided by Sphinx](http://www.sphinx-doc.org/en/stable/domains.html#the-standard-domain). You can simply reference those using the standard Sphinx roles, like so: :option:`dest_dir` :program:`test` :envvar:`my_env_var` I'm keeping this...

@kvalev Indeed. Looks like this is a gap, but I think the way to resolve that is in upstream Sphinx - not here.

@abey79 I have no issues using our own domain. It's just a case of finding the time to do so. If you think you'd have the cycles, I'm more than...

I suspect it should be a new, custom domain. The Sphinx docs [provide examples of how to do this](https://www.sphinx-doc.org/en/master/development/tutorials/recipe.html) if you haven't done so before. We'll want a custom domain,...

The oslo.config and oslo.policy projects from Openstack both provide custom domains with directives and roles that should be pretty easy to understand. Look for the `sphinxext` module in both