diff --git a/docs/misc/api-stability.txt b/docs/misc/api-stability.txt index 9fa43286e1..52fd430011 100644 --- a/docs/misc/api-stability.txt +++ b/docs/misc/api-stability.txt @@ -68,7 +68,10 @@ of 1.0. This includes these APIs: - :ref:`Templates `, including the language, Python-level :ref:`template APIs `, and :ref:`custom template tags - and libraries `. + and libraries `. We may add new template + tags in the future and the names may inadvertently clash with + external template tags. Before adding any such tags, we'll ensure that + Django raises an error if it tries to load tags with duplicate names. - :ref:`Testing `