Update documentation and changelog

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

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**
 *********

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