Open Stack

> >
> > The rendering on PyPi, and the validation that they do that will reject the
> > package upload if it has README syntax errors, is not aware of any Sphinx
> > extensions we use in our normal docs, so pulling in other documentation into
> > the README could potentially cause release issues.
>
> Good point. Maybe we should just stop including README content in sphinx
> docs, and not do anything additional that's more complex?

That would be my preference. :)