Add note about the broken docs problem.

1 files changed, 14 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index bb3d912..5196a10 100644
--- a/README.rst
+++ b/README.rst
@@ -8,6 +8,20 @@
 .. image:: https://img.shields.io/travis/jaraco/skeleton/master.svg
    :target: http://travis-ci.org/jaraco/skeleton
 
+
+License
+=======
+
 License is indicated in the project metadata (typically one or more
 of the Trove classifiers). For more details, see `this explanation
 <https://github.com/jaraco/skeleton/issues/1>`_.
+
+Docs
+====
+
+There's `no good mechanism for publishing documentation
+<https://github.com/pypa/python-packaging-user-guide/pull/266>`_
+easily. If there's a documentation link above, it's probably
+stale because PyPI-based documentation is deprecated. This
+project may have documentation published at ReadTheDocs, but
+probably not. Good luck finding it.