investigate rtd warnings

[jessdtate]

there are several warnings in the sphinx build, including missing references. These should trigger a build fail on PR.