diff --git a/dev-python/stdio-mgr/metadata.xml b/dev-python/stdio-mgr/metadata.xml
index 628ab20176..ebddacad23 100644
--- a/dev-python/stdio-mgr/metadata.xml
+++ b/dev-python/stdio-mgr/metadata.xml
@@ -2,8 +2,21 @@
 <!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
 
 <pkgmetadata>
-    <maintainer type="person">
-        <email>andrewammerlaan@riseup.net</email>
-        <name>Andrew Ammerlaan</name>
-    </maintainer>
+  <maintainer type="person">
+    <email>andrewammerlaan@riseup.net</email>
+    <name>Andrew Ammerlaan</name>
+  </maintainer>
+  <longdescription>
+Have a CLI Python application?
+
+Want to automate testing of the actual console input &amp; output of your user-facing components?
+
+stdio Manager can help.
+
+While some functionality here is more or less duplicative of redirect_stdout and redirect_stderr in contextlib within the standard library, it provides (i) a much more concise way to mock both stdout and stderr at the same time, and (ii) a mechanism for mocking stdin, which is not available in contextlib.
+  </longdescription>
+  <upstream>
+    <remote-id type="github">bskinn/stdio-mgr</remote-id>
+    <remote-id type="pypi">stdio-mgr</remote-id>
+  </upstream>
 </pkgmetadata>
diff --git a/dev-python/stdio-mgr/stdio-mgr-1.0.1.ebuild b/dev-python/stdio-mgr/stdio-mgr-1.0.1.ebuild
index e91fe106a5..defb206871 100644
--- a/dev-python/stdio-mgr/stdio-mgr-1.0.1.ebuild
+++ b/dev-python/stdio-mgr/stdio-mgr-1.0.1.ebuild
@@ -3,12 +3,15 @@
 
 EAPI=7
 
-PYTHON_COMPAT=( python3_{6,7,8} )
+PYTHON_COMPAT=( python3_6 )
 
 inherit distutils-r1
 
 DESCRIPTION="Context manager for mocking/wrapping stdin/stdout/stderr"
-HOMEPAGE="https://github.com/bskinn/stdio-mgr"
+HOMEPAGE="
+	https://github.com/bskinn/stdio-mgr
+	https://pypi.org/project/stdio-mgr
+"
 SRC_URI="https://github.com/bskinn/${PN}/archive/v${PV}.tar.gz -> ${P}.tar.gz"
 
 LICENSE="MIT"
@@ -16,7 +19,11 @@ KEYWORDS="~amd64 ~x86 "
 SLOT="0"
 
 distutils_enable_tests pytest
+distutils_enable_sphinx doc \
+				dev-python/sphinxcontrib-programoutput \
+				dev-python/sphinx_rtd_theme
 
+#is this necessary?
 python_test() {
 	pytest -vv tests || "Tests fail with ${EPYTHON}"
 }