Improve changelog

Author: dmerejkowsky

README.rst

@@ -5,10 +5,10 @@ Tools for nice user interfaces in the terminal.
 
 .. image:: https://img.shields.io/travis/TankerHQ/python-cli-ui.svg?branch=master
   :target: https://travis-ci.org/TankerHQ/python-cli-ui
-  
+
 .. image:: https://img.shields.io/pypi/pyversions/cli-ui.svg
   :target: https://pypi.org/project/cli-ui
-   
+
 .. image:: https://img.shields.io/pypi/v/cli-ui.svg
   :target: https://pypi.org/project/cli-ui/
 

docs/changelog.rst

@@ -19,11 +19,20 @@ Highlights
 ~~~~~~~~~~
 
 * **Breaking change**: Rename main package from ``ui`` to ``cli_ui``. This name is less likely to
-  cause clash with existing code.
+  cause clash with existing code::
 
+    # old (<= 0.7)
+    import ui
+    ui.info("This is", ui.green, "green")
 
-* **Breaking change** Instead of hard-coding ANSI sequences names and values, use `colorama` instead.
-  All existing names have been kept, but some of the values changed slighlty.
+    # new (>= 0.8)
+    import cli_ui
+    cli_ui.info("This is", cli_ui.green, "green")
+
+
+
+* **Breaking change**:  use `colorama` instead of hard-coding ANSI sequences names and values
+  of `cli_ui` constants. All existing names have been kept, but some of the values changed slighlty.
 
 * ``ask_`` functions now take a variable number of tokens as first argument.
   This allows to color the prompt when requiring input from the user, for instance::