diff --git a/README.rst b/README.rst
index 76ddbb7..65b86f2 100644
--- a/README.rst
+++ b/README.rst
@@ -359,7 +359,7 @@ https://drf-yasg.readthedocs.io/en/latest/
    :alt: Codecov
 
 .. |pypi-version| image:: https://img.shields.io/pypi/v/drf-yasg.svg
-   :target: https://pypi.org/project/drf-yasg/
+   :target: https://pypi.python.org/pypi/drf-yasg/
    :alt: PyPI
 
 .. |rtd-badge| image:: https://img.shields.io/readthedocs/drf-yasg.svg
diff --git a/docs/changelog.rst b/docs/changelog.rst
index d8f1158..845c062 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -3,6 +3,12 @@ Changelog
 #########
 
 
+*********
+**1.0.5**
+*********
+
+- **FIX:** fixed a crash caused by having read-only Serializers nested by reference
+
 *********
 **1.0.4**
 *********
diff --git a/docs/custom_spec.rst b/docs/custom_spec.rst
index 81e7ee0..2541b1a 100644
--- a/docs/custom_spec.rst
+++ b/docs/custom_spec.rst
@@ -242,7 +242,12 @@ Where you can use the :func:`@swagger_auto_schema <.swagger_auto_schema>` decora
          url(r'^login/$', decorated_login_view, name='login')
       ]
 
-      This can allow you to avoid skipping an unnecessary *subclass* altogether.
+   This can allow you to avoid skipping an unnecessary *subclass* altogether.
+
+.. Warning::
+
+   However, do note that both of the methods above can lead to unexpected (and maybe surprising) results by
+   replacing/decorating methods on the base class itself.
 
 *************************
 Subclassing and extending