Update change log

Author: jg-rp

CHANGES.md

@@ -5,20 +5,20 @@
 This is a major release with several breaking changes. As well as API changes listed below, we:
 
 - Drop support for Python version 3.7 and 3.8.
-- Promotes rendering behavior from `liquid.future.Environment` to be the default, so as to improve Shopify/liquid compatibility by default.
-- Fixe variable/identifier/path parsing described in [issue #39](https://github.com/jg-rp/liquid/issues/39).
+- Promote rendering behavior from `liquid.future.Environment` to be the default, so as to improve Shopify/liquid compatibility by default.
+- Fix variable/identifier/path parsing described in [issue #39](https://github.com/jg-rp/liquid/issues/39).
 - Improve Liquid syntax error messages and exposes source index, line numbers and column numbers through methods on Liquid exceptions. See [#53](https://github.com/jg-rp/liquid/issues/53).
 - Change comment tag parsing to better match Shopify/Liquid. See [#133](https://github.com/jg-rp/liquid/issues/133).
 - Remove `BoundTemplate.analyze_with_context()`. Shout if you need contextual analysis and we'll restore this feature.
 - Remove the `cache_size` argument to `liquid.Environment` and `liquid.Template`. Template caching is now handled by template loaders.
 - Remove the `expression_cache_size` argument to `liquid.Environment` and `liquid.Template`. Environment-level expression caching is no longer available as it does not play nicely with detailed error messages. If you need to cache parsing of Liquid expressions, it is now recommended to implement a cache per tag, where it makes sense to do so for your use case.
-- Make markupsafe>=3 a dependency. Previously markupsafe was an optional dependency. Version 3 of markupsafe brings some subtle changes to the `replace`, `replace_first` and `replace_last` filters when they receive a "safe" string wrapped in `Markup()`.
-- Add new filters `reject`, `has`, `find` and `find_index`.
-- Add the new `doc` tag.
+- Make [markupsafe](https://pypi.org/project/MarkupSafe/) a dependency. Previously markupsafe was an optional dependency. Version 3 of markupsafe brings some subtle changes to the `replace`, `replace_first` and `replace_last` filters when they receive a "safe" string wrapped in `Markup()`.
+- Add new filters `reject`, `has`, `find` and `find_index`. See [Shopify/liquid #1869](https://github.com/Shopify/liquid/pull/1869).
+- Add the new `doc` tag. See [Shopify/liquid #1895](https://github.com/Shopify/liquid/pull/1895).
 
 ### API changes
 
-Also see the [migration guide].
+Also see the [migration guide](https://jg-rp.github.io/liquid/migration/).
 
 #### Miscellaneous
 

docs/index.md

@@ -2,7 +2,9 @@
 
 Python Liquid is a Python engine for the Liquid, the safe, customer-facing template language. We follow [Shopify/Liquid](https://github.com/Shopify/liquid) closely and test against the [Golden Liquid test suite](https://github.com/jg-rp/golden-liquid).
 
-This is the documentation for the latest version of Python Liquid ([GitHub](https://github.com/jg-rp/liquid)). Find archived documentation for Python Liquid version 1.x [here](https://jg-rp.github.io/python-liquid-docs-archive/).
+!!! note
+
+    This is the documentation for the latest version of Python Liquid ([GitHub](https://github.com/jg-rp/liquid)). Find archived documentation for Python Liquid version 1.x [here](https://jg-rp.github.io/python-liquid-docs-archive/).
 
 ## Install
 
@@ -34,7 +36,7 @@ conda install -c conda-forge python-liquid
 
 ### `render()`
 
-Here's a very simple example that renders a template from a string of text with the package-level [`render()`](api/convenience.md#liquid.render) function. The template has just one placeholder variable `you`, which we've given the value `"World"`.
+This example renders a template from a string of text with the package-level [`render()`](api/convenience.md#liquid.render) function. The template has just one placeholder variable `you`, which we've given the value `"World"`.
 
 ```python
 from liquid import render