Update docs

Author: alshan

CHANGELOG.md

@@ -2,17 +2,47 @@
 
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres
+to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.0] - 2021-01-15
+
+### Added
+
+- Correlation plot builder.
+
+  Example: [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
+
+- The `gggrid()` plot layout utility
+
+  Example: [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
+
+- In tooltip customization API:
+    - options: `center` and `middle` (anchor).
+    - option 'minWidth'.
+
+  Example: [tooltip_config.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/tooltip_config.ipynb)
+
+- The `naText` parameter in `geom_text()`
+
+### Changed
+
+- Built with Lets-Plot v1.5.6 (was v1.5.4).
+
+  See Lets-Plot [CHANGELOG.md](https://github.com/JetBrains/lets-plot/blob/master/CHANGELOG.md) for changes and fixes in
+  1.5.5, 1.5.6.
 
 ## [1.1.0] - 2020-11-20
+
 ### Added
- - GeoTools support (see [geotools.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/geotools.md)).
- - API for tooltip customization (see [tooltips.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/tooltips.md)).
- - `geom_map()`.
- - `labelFormat` parameter in `geom_text()`.
- - `reverse` parameter in `scale_x/y_discrete()`.
- - `scale_x_discrete_reversed()`, `scale_y_discrete_reversed()`
+
+- GeoTools support (see [geotools.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/geotools.md)).
+- API for tooltip customization (
+  see [tooltips.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/tooltips.md)).
+- `geom_map()`.
+- `labelFormat` parameter in `geom_text()`.
+- `reverse` parameter in `scale_x/y_discrete()`.
+- `scale_x_discrete_reversed()`, `scale_y_discrete_reversed()`
 
 ### Changed
  - Built with Lets-Plot v1.5.4 (was v1.5.2).

README.md

@@ -38,14 +38,14 @@
 - [Lets-Plot in JVM-based application](#jvm)   
 
 - [Lets-Plot Kotlin API](#api)
-    - [User guide and API reference](#guide)
-    - [Data sampling](#sampling)
-    - [GGBunch](#ggbunch)
-    - [Saving plot to file](#export)
-    - [Tooltip customization](#tooltip-customization)
-    - [GeoTools support](#geotools)
-        
-- [What is new in 1.1.0](#new)
+  - [User guide and API reference](#guide)
+  - [Data sampling](#sampling)
+  - [GGBunch](#ggbunch)
+  - [Saving plot to file](#export)
+  - [Tooltip customization](#tooltip-customization)
+  - [GeoTools support](#geotools)
+
+- [What is new in 1.2.0](#new)
 - [Change log](#change_log)
 - [License](#license)    
 
@@ -235,32 +235,50 @@ Learn more: [Tooltip Customization](https://github.com/JetBrains/lets-plot-kotli
 
 [GeoTools](https://www.geotools.org/) is an open source Java GIS Toolkit.
 
-Lets-Plot supports visualization of a set of `SimpleFeature`-s stored in `SimpleFeatureCollection`, as well as 
-individual `Geometry` and `ReferencedEnvelope` objects. 
+Lets-Plot supports visualization of a set of `SimpleFeature`-s stored in `SimpleFeatureCollection`, as well as
+individual `Geometry` and `ReferencedEnvelope` objects.
 
 Learn more: [GeoTools Support](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/geotools.md).
- 
 
 <a id="new"></a>
-## What is new in 1.1.0
 
-- Tooltip Customization
+## What is new in 1.2.0
+
+- Correlation plot builder.
+
+  Usage:
+  ```kotlin
+  import jetbrains.letsPlot.bistro.corr.CorrPlot
+  
+  val plot = CorrPlot(data, title = "threshold = 0.5, no diag", threshold = 0.5) // data and optional parameters
+      .points(type = "upper", diag = true) // Add one or more layers
+      .build()  // Finally, build the plot
+  ```
+
+  Example: [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
+
 
-    New API for customization of tooltip contents. See [Tooltip Customization](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/tooltips.md)) for details.
- 
-- Formatting labels in `geom_text()`
+- The `gggrid()` plot layout utility
 
-    New parameter, 'labelFormat' to define a formatting pattern.
+  Arranges plots in cells of a regular grid.
 
-    See demo: [label_format.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/label_format.ipynb)
-    
-- GeoTools support
+  Example: [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
 
-    Visualization of GeoTools's `SimpleFeature`-s and other objects. See [GeoTools Support](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/geotools.md)) for details.
 
-- Other changes and fixes - see [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md) for details.       
+- Tooltip Customization API
+  - new options: `center` and `middle` (anchor).
+  - new option `minWidth`.
+
+  See [Tooltip Customization](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/tooltips.md) for details.
+
+  Example: [tooltip_config.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/tooltip_config.ipynb)
+
+
+- Other changes and fixes - see [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md)
+  for details.
 
 <a id="change_log"></a>
+
 ## Change Log
 
 See [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md).

docs/examples.md

@@ -9,10 +9,12 @@ Try the following tutorials and examples to learn and evaluate various features
 - [Facets](#facets)
 - [GGBunch](#ggbunch)
 - [`as_discrete()` function](#as_discrete)
+- [gggrid()](#gggrig)
 - [Export to File](#export)
 - [Theme](#theme)
 - [Data Sampling](#sampling)
 - [Tooltip Customization](#tooltip)
+- [Correlation Plot](#corrplot)
 - [GeoTools Support](#geotools)
 
 <a id="quickstart"></a>
@@ -75,23 +77,32 @@ Try the following tutorials and examples to learn and evaluate various features
 * `facet_grid`: 
 [distributions.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/distributions.ipynb)
 
-
 <a id="ggbunch"></a>
+
 #### GGBunch
 
-GGBunch allows to show a collection of plots on one figure. Each plot in the collection can have arbitrary location and size. There is no automatic layout inside the bunch.
+GGBunch allows to show a collection of plots on one figure. Each plot in the collection can have arbitrary location and
+size. There is no automatic layout inside the bunch.
+
+* [ggbunch.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/ggbunch.ipynb)
+* [geom_smooth.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/geom_smooth.ipynb)
+
+<a id="gggrid"></a>
+
+#### gggrid()
 
-* [ggbunch.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/ggbunch.ipynb) 
-* [geom_smooth.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/geom_smooth.ipynb) 
+A simple utility which you can use to arrange plots in a regular grid.
 
+* [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
 
 <a id="as_discrete"></a>
-#### `as_discrete()` function 
 
-* [geom_smooth.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/geom_smooth.ipynb) 
+#### `as_discrete()` function
 
+* [geom_smooth.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/geom_smooth.ipynb)
 
 <a id="export"></a>
+
 #### Export to File
 
 The `ggsave()` function is an easy way to export plot to a file in SVG, HTML or raster formats.
@@ -113,16 +124,25 @@ Sampling is a special technique of data transformation, which helps dealing with
 
 See: [Sampling in Lets-Plot](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/sampling.md).
 
-* Pick sampling on Bar-chart: [sampling_pick.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/sampling_pick.ipynb)
-* Stratified sampling: [sampling_stratified.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/sampling_stratified.ipynb)
+* Pick sampling on
+  Bar-chart: [sampling_pick.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/sampling_pick.ipynb)
+* Stratified
+  sampling: [sampling_stratified.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/sampling_stratified.ipynb)
 
 <a id="tooltip"></a>
+
 #### Tooltip Customization
 
 * [tooltip_config.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/tooltip_config.ipynb)
 
+<a id="corrplot"></a>
+
+#### Correlation Plot
+
+* [correlation_plot.ipynb](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/correlation_plot.ipynb)
 
 <a id="geotools"></a>
+
 #### GeoTools Support
 
 See [GeoTools Support](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/geotools.md).

future_changes.md

@@ -1,12 +1,3 @@
-## [1.1.1] - 2021-xx-xx
+## [1.2.1] - 2021-xx-xx
 
 ### Added
-
-- In tooltip customization API:
-   - options: `center` and `middle` (anchor).
-   - option 'minWidth'.
-
-See: [Tooltip Customization](https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/tooltips.md).
-
-- `gggrid()` - arranges plots in cells of a regular grid.
-- `naText` parameter in 'geom_text'