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

@@ -244,6 +244,11 @@ Where you can use the :func:`@swagger_auto_schema <.swagger_auto_schema>` decora
 
    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
 *************************