cleanup release notes
Bokeh Version ``0.12.7`` is an incremental update that adds a few important
features and fixes several bugs. Some of the highlights include:
-New embed methods
-~~~~~~~~~~~~~~~~~
+Better Embed Functions for Applications
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Two new embed methods were added: ``server_document`` and ``server_session``.
-Those methods work similarly to ``autoload_server`` except for a few differences:
-with ``server_document`` a new session will systematically be generated and
-an entire document will be returned; with ``server_session`` an existing session
-id and model must be provided. Another difference from ``autoload_server`` is
-that with those two new methods one may choose to not load the JS/CSS resource
-files by passing a ``resources="none"`` parameter.
+Two new embed functions similar to ``autoload_server`` are added, that have
+simpler APIs and are more focused:
+
+* :func:`bokeh.embed.server_document` for embedding new sessions for entire
+ Bokeh documents in HTML pages. (More common)
+
+* :func:`bokeh.embed.server_session` for embedding existing sessions for
+ specified Bokeh models in HTML pages (Less common)
+
+Additionally, with these new methods one may choose to not load the JS/CSS
+resource files by passing ``resources="none"`` as a parameter.
New Deprecations
~~~~~~~~~~~~~~~~
-``bokeh.embed.autoload_server`` has been deprecated in place of
-``bokeh.embed.server_document`` and ``bokeh.embed.server_session``.
+``bokeh.embed.autoload_server`` has been deprecated and replaced with the
+two simpler functions :func:`~bokeh.embed.server_document` and
+:func:`~bokeh.embed.server_session` described above.
``bokeh.models.tools.tool_events`` has been deprecated. Users should instead
-use the ``SelectionGeometry`` Event present on ``Plot`` or ``Figure``.
+use the ``SelectionGeometry`` event present on ``Plot`` or ``Figure``.
+
+``DynamicImageRenderer`` and ``Plot.add_dyanamic_image`` have been deprecated.
+For GIS-related use-cases built on top of Bokeh, consider using
+GeoViews_, or creating a `Custom Extension`_.
+
+BokehJS Widgets Bundle Split
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-bokeh-widgets' split
-~~~~~~~~~~~~~~~~~~~~
+The `bokeh-widgets` bundle was split into ``bokeh-widgets`` and
+``bokeh-tables``. This is to reduce the weight of the main widgets' bundle.
+Bokeh includes ``bokeh-tables`` automatically when necessary, so this change
+should be transparent for most users. However, users of custom templates or
+other advanced embedding scenarios may be affected.
-`bokeh-widgets` bundle was split into `bokeh-widgets` and `bokeh-tables`. This
-is to reduce the weight of the main widgets' bundle. bokeh includes `bokeh-tables`
-automatically when necessary, so this change should be transparent for most users.
-However, users of custom templates or some advanced embedding scenarios may be
-affected.
+.. _Custom Extension: http://bokeh.pydata.org/en/latest/docs/user_guide/extensions.html
+.. _GeoViews: http://geo.holoviews.org
