diff --git a/Writerside/cfg/static/custom.css b/Writerside/cfg/static/custom.css
index c9522d841..e3f3357da 100644
--- a/Writerside/cfg/static/custom.css
+++ b/Writerside/cfg/static/custom.css
@@ -1,3 +1,11 @@
+/* Common */
+
+ul li[data-toc-scroll='toc-api-reference'] a::after {
+  content: none;
+}
+
+/* Named colors tables */
+
 div[data-tab-id="by-shade"] div.table>div {
   width: 100%;
   border: none;
diff --git a/Writerside/images/plots/plot_layout_scheme.png b/Writerside/images/plots/plot_layout_scheme.png
index ac7c28fc8..6c5a7cb5e 100644
Binary files a/Writerside/images/plots/plot_layout_scheme.png and b/Writerside/images/plots/plot_layout_scheme.png differ
diff --git a/Writerside/lpk.tree b/Writerside/lpk.tree
index e894fdc82..a619a4efa 100644
--- a/Writerside/lpk.tree
+++ b/Writerside/lpk.tree
@@ -7,7 +7,7 @@
                  start-page="get-started.md">
 
     <toc-element topic="get-started.md"/>
-    <toc-element href="%api_reference%" toc-title="API Reference"/>
+    <toc-element href="%api_reference%" toc-title="API Reference" id="toc-api-reference"/>
     <toc-element topic="gallery.md"/>
     <toc-element topic="charts.md"/>
     <toc-element topic="whats_new.md"/>
diff --git a/Writerside/source/in-head.html b/Writerside/source/in-head.html
index 344154524..cf282a467 100644
--- a/Writerside/source/in-head.html
+++ b/Writerside/source/in-head.html
@@ -2,22 +2,32 @@
     document.addEventListener("DOMContentLoaded", onDOMContentLoaded);
 
     function onDOMContentLoaded() {
-        addGitHubLinkToHeader();
+        whenLoaded("header .wh-header a.wh-header__link").then(fixLogoLink);
+        whenLoaded("header .wh-header").then(addGitHubLinkToHeader);
+        whenLoaded("ul li[data-toc-scroll='toc-api-reference'] a").then(fixAPIReferenceTocLink);
     }
 
-    function addGitHubLinkToHeader() {
+    function fixLogoLink(linkElem) {
+        makeLinkInternal(linkElem);
+    }
+
+    function addGitHubLinkToHeader(headerElem) {
         function createGitHubLink() {
             const gitHubLinkElem = document.createElement("a");
             gitHubLinkElem.setAttribute("href", "https://github.com/JetBrains/lets-plot-kotlin");
             gitHubLinkElem.setAttribute("id", "github-repo-link");
+            gitHubLinkElem.setAttribute("target", "_blank");
             return gitHubLinkElem;
         }
 
-        whenLoaded("header .wh-header").then((headerElem) => {
-            const switchersElem = headerElem.querySelector(".wh-header__switchers");
-            const gitHubLinkElem = createGitHubLink();
-            headerElem.insertBefore(gitHubLinkElem, switchersElem);
-        });
+        const switchersElem = headerElem.querySelector(".wh-header__switchers");
+        const gitHubLinkElem = createGitHubLink();
+        headerElem.insertBefore(gitHubLinkElem, switchersElem);
+    }
+
+    function fixAPIReferenceTocLink(linkElem) {
+        const isInternal = makeLinkInternal(linkElem);
+        if (isInternal) linkElem.classList.remove("toc-item--external");
     }
 
     function whenLoaded(selector) {
@@ -37,6 +47,14 @@
             }
         });
     }
+
+    function makeLinkInternal(linkElem) {
+        const href = linkElem.getAttribute("href");
+        if (!href.startsWith("https://lets-plot.org")) return false;
+        linkElem.removeAttribute("target");
+        linkElem.dataset.test = linkElem.dataset.test.replace("external-link", "internal-link");
+        return true;
+    }
 </script>
 
 <style>
diff --git a/Writerside/topics/annotations.md b/Writerside/topics/annotations.md
index 66ab03ca7..809ac7c72 100644
--- a/Writerside/topics/annotations.md
+++ b/Writerside/topics/annotations.md
@@ -1,12 +1,31 @@
 # Annotating Charts
 
-You can customize the content of annotations for pie, bar and crossbar charts by using the `labels` parameter of the corresponding functions.
-The parameter takes as value the result of the [`layerLabels()`](%api_annotations%/layer-labels/index.html) function call.
+Lets-Plot provides several ways to annotate charts:
 
-[Learn more (datalore link)](%nbp-annotations%).
+- **Label annotations for geometry layers.**
+  Some geoms (such as pie, bar, and crossbar) support built-in text labels via the
+  `labels` parameter. Pass the result of the [`layerLabels()`](%api_annotations%/layer-labels/index.html)
+  call to configure the label content and layout.
 
-See also the [formatting reference](formats.md) to learn how to format numeric and date-time values in annotations.
+  [Learn more (reference notebook)](%nbp-annotations%).
+
+- **Annotations for** [`geomSmooth()`](%api_geom%/geom-smooth/index.html).
+  Use the `labels` parameter together with [`smoothLabels()`](%api_annotations%/smooth-labels/index.html)
+  to display statistics computed by the `smooth` stat (for example, R², adjusted R²,
+  and a fitted model equation). `smoothLabels` extends `layerLabels`, so formatting and text
+  template helpers work the same way.
+
+  [Learn more (reference notebook)](%nb-smooth_summary%).
 
+- **Bracket annotations.**
+  Use [`geomBracket()`](%api_geom%/geom-bracket/index.html) to add labeled brackets highlighting
+  relationships between categories or marking an interval.
+  Use [`geomBracketDodge()`](%api_geom%/geom-bracket-dodge/index.html) to draw brackets that connect
+  *dodged* groups within each category (e.g., comparisons inside grouped boxplots/bars).
+
+  [Learn more (reference notebook)](%nb-geom_bracket%).
+
+See also the [formatting reference](formats.md) to learn how to format numeric and date-time values in annotations.
 
 ## Examples
 
diff --git a/Writerside/topics/charts.md b/Writerside/topics/charts.md
index 9024bc298..5568db987 100644
--- a/Writerside/topics/charts.md
+++ b/Writerside/topics/charts.md
@@ -113,6 +113,8 @@ Cookbooks:
 - [Lollipop plot](%nb-geom_lollipop%)
 - [Count stat](%nb-stat_count_2d%)
 - [Handling an overplotting on a scatter plot: `geomCount()`/`statSum()`](%nb-geom_count%)
+- [Generating color palettes with scale.palette()](%nb-scale_color_palette%)
+- [Handling color overflow in brewer palettes](%nb-scale_brewer_overflow%)
 - [Viridis colors](%nb-colors_viridis%)
 
 
@@ -231,6 +233,8 @@ Cookbooks:
 *Lets-Plot* handles all temporal data types through a unified "datetime" scale (excluding duration, which is handled by the "time" scale).
 This is in contrast to R's ggplot2, which provides separate "date", "time", and "datetime" scales.
 
+Use `breakWidth` in datetime and duration scales to control the axis break interval using human-readable strings like `"3 months"` or `"2 hours"`.
+
 **Supported temporal data types**:
 
 - `kotlinx.datetime` library:
@@ -257,6 +261,8 @@ Cookbooks:
 
 - [Scale time](%nb-scale_time%)
 - [Plotting time series](%nb-time_date_datetime%)
+- [`breakWidth` parameter in datetime scales](%nb-scale_break_width_datetime%)
+- [`breakWidth` parameter in time (duration) scales](%nb-scale_break_width_duration%)
 
 Demos:
 
@@ -273,6 +279,7 @@ Cookbooks:
 - [The `extent` parameter](%nb-image_extent%)
 - [Parameters `norm`, `vmain` and `vmax`](%nb-image_grayscale%)
 - ["Fisher boat": `geomImshow()` and raster data](%nb-image_fisher_boat%)
+- [Custom color palettes in `geomImshow()`](%nb-image_custom_cmap%)
 
 
 ## Coordinate Systems
@@ -289,6 +296,28 @@ Cookbooks:
 - [Polar coordinate system](%nb-coord_polar%)
 
 
+## Positional Scales
+
+[`scaleXDiscrete()`](%api_scale%/scale-x-discrete.html),
+[`scaleYDiscrete()`](%api_scale%/scale-y-discrete.html),
+[`scaleXDiscreteReversed()`](%api_scale%/scale-x-discrete-reversed.html),
+[`scaleYDiscreteReversed()`](%api_scale%/scale-y-discrete-reversed.html),
+[`scaleXContinuous()`](%api_scale%/scale-x-continuous.html),
+[`scaleYContinuous()`](%api_scale%/scale-y-continuous.html),
+[`scaleXLog10()`](%api_scale%/scale-x-log10.html),
+[`scaleYLog10()`](%api_scale%/scale-y-log10.html),
+[`scaleXLog2()`](%api_scale%/scale-x-log2.html),
+[`scaleYLog2()`](%api_scale%/scale-y-log2.html),
+[`scaleXReverse()`](%api_scale%/scale-x-reverse.html),
+[`scaleYReverse()`](%api_scale%/scale-y-reverse.html)
+
+Cookbooks:
+
+- [Axis position](%nb-axis_position%)
+- [`breakWidth` parameter in position scales](%nb-scale_break_width_log10%)
+- [Formatting labels on plots](%nb-formatting_axes_etc%)
+
+
 ## Legends and Guides
 
 [`guideLegend()`](%api_scale%/guide-legend.html),
diff --git a/Writerside/topics/formats.md b/Writerside/topics/formats.md
index 62c52ef38..b4fd743fb 100644
--- a/Writerside/topics/formats.md
+++ b/Writerside/topics/formats.md
@@ -131,8 +131,8 @@ The number format can be used in a template to create a string with variable sub
 The string template contains “replacement fields” surrounded by curly braces `{}`.
 Anything that is not contained in braces is considered literal text, which is copied unchanged to the result string.
 If you need to include a brace character in the literal text, it can be escaped by doubling: `{{` and `}}`.
-This approach is used in functions [`layerTooltips()`](%api_tooltips%/layer-tooltips/index.html) and [`layerLabels()`](%api_annotations%/layer-labels/index.html)
-to customize the content of tooltips and annotations.
+This approach is used in functions [`layerTooltips()`](%api_tooltips%/layer-tooltips/index.html), [`layerLabels()`](%api_annotations%/layer-labels/index.html) and
+[`smoothLabels()`](%api_annotations%/smooth-labels/index.html) to customize the content of tooltips and annotations.
 
 See: [Tooltip Customization in Lets-Plot](tooltips.md) and [Annotating Charts in Lets-Plot](annotations.md).
 
@@ -239,7 +239,7 @@ To format the axis tooltips, follow the rules:
 
 ## Annotating Charts
 
-You can format text in annotations, see: [Annotating Charts](annotations.md).
+Use formatting in annotation labels and templates (e.g., via [`format()`](%api_tooltips%/layer-tooltips/format.html)); see: [Annotating Charts](annotations.md).
 
 ## Demo Notebooks
 
diff --git a/Writerside/topics/multiplot.md b/Writerside/topics/multiplot.md
index c98bbb9d6..ae0886aa8 100644
--- a/Writerside/topics/multiplot.md
+++ b/Writerside/topics/multiplot.md
@@ -29,4 +29,14 @@ Cookbooks:
 
 - [The `gggrid()` function](%nb-plot_grid%)
 - [Sharing X,Y-axis scale limits](%nb-gggrid_scale_share%)
-- [Collecting guides in gggrid()](%nb-gggrid_legend_collect%)
\ No newline at end of file
+- [Interactive pan/zoom with shared axes in gggrid](%nb-gggrid_scale_share_zoom%)
+- [Collecting guides in gggrid()](%nb-gggrid_legend_collect%)
+
+## Plot Tags
+
+Plot tags are short labels attached to subplots and composite figures (panel labels, figure numbering).
+Specify them via `labs(tag = ...)` and tune placement/style with `plotTag*` in [`theme()`](%api_theme%/theme/index.html).
+
+Cookbooks:
+
+- [Plot tags](%nb-plot_tags%)
\ No newline at end of file
diff --git a/Writerside/topics/whats_new.md b/Writerside/topics/whats_new.md
index 80c93b879..39451f4f4 100644
--- a/Writerside/topics/whats_new.md
+++ b/Writerside/topics/whats_new.md
@@ -104,6 +104,6 @@
     </li>
 </list>
 
-## Change Log
+## Changelog
 
 See [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md) for other changes and fixes.
\ No newline at end of file
diff --git a/Writerside/v.list b/Writerside/v.list
index bbb11350f..cc9261e72 100644
--- a/Writerside/v.list
+++ b/Writerside/v.list
@@ -85,6 +85,7 @@
     <var name="nb-font_size_and_family" value="%nbviewer_cookbook%/font_size_and_family.ipynb"/>
     <var name="nb-formatting" value="%nbviewer_cookbook%/formatting.ipynb"/>
     <var name="nb-formatting_axes_etc" value="%nbviewer_cookbook%/formatting_axes_etc.ipynb"/>
+    <var name="nb-geom_bracket" value="%html_cookbook%/geom_bracket.html"/>
     <var name="nb-geom_count" value="%nbviewer_cookbook%/geom_count.ipynb"/>
     <var name="nb-geom_curve" value="%nbviewer_cookbook%/geom_curve.ipynb"/>
     <var name="nb-geom_dotplot" value="%nbviewer_cookbook%/geom_dotplot.ipynb"/>
@@ -101,14 +102,16 @@
     <var name="nb-geom_violin" value="%nbviewer_cookbook%/geom_violin.ipynb"/>
     <var name="nb-geom_ydotplot" value="%nbviewer_cookbook%/geom_ydotplot.ipynb"/>
     <var name="nb-ggbunch" value="%nbviewer_cookbook%/ggbunch.ipynb"/>
-    <var name="nb-ggrepel" value="%nbviewer_cookbook%/ggrepel.ipynb"/>
     <var name="nb-gggrid_legend_collect" value="%html_cookbook%/gggrid_legend_collect.html"/>
     <var name="nb-gggrid_scale_share" value="%nbviewer_cookbook%/gggrid_scale_share.ipynb"/>
+    <var name="nb-gggrid_scale_share_zoom" value="%html_cookbook%/gggrid_scale_share_zoom.html"/>
+    <var name="nb-ggrepel" value="%nbviewer_cookbook%/ggrepel.ipynb"/>
     <var name="nb-graph_edges" value="%nbviewer_cookbook%/graph_edges.ipynb"/>
     <var name="nb-group_override_defaults" value="%html_cookbook%/group_override_defaults.html"/>
     <var name="nb-hjust_vjust" value="%nbviewer_cookbook%/hjust_vjust.ipynb"/>
     <var name="nb-horizontal_geoms" value="%nbviewer_cookbook%/horizontal_geoms.ipynb"/>
     <var name="nb-image_101" value="%nbviewer_cookbook%/image_101.ipynb"/>
+    <var name="nb-image_custom_cmap" value="%html_cookbook%/image_custom_cmap.html"/>
     <var name="nb-image_extent" value="%nbviewer_cookbook%/image_extent.ipynb"/>
     <var name="nb-image_fisher_boat" value="%nbviewer_cookbook%/image_fisher_boat.ipynb"/>
     <var name="nb-image_grayscale" value="%nbviewer_cookbook%/image_grayscale.ipynb"/>
@@ -129,6 +132,7 @@
     <var name="nb-panel_border" value="%nbviewer_cookbook%/panel_border.ipynb"/>
     <var name="nb-param_width_unit" value="%nbviewer_cookbook%/param_width_unit.ipynb"/>
     <var name="nb-plot_grid" value="%nbviewer_cookbook%/plot_grid.ipynb"/>
+    <var name="nb-plot_tags" value="%html_cookbook%/plot_tags.html"/>
     <var name="nb-position_nudge_unit" value="%nbviewer_cookbook%/position_nudge_unit.ipynb"/>
     <var name="nb-position_stack" value="%nbviewer_cookbook%/position_stack.ipynb"/>
     <var name="nb-projection_provided" value="%nbviewer_cookbook%/projection_provided.ipynb"/>
@@ -141,10 +145,16 @@
     <var name="nb-ridgeline_plot" value="%nbviewer_cookbook%/ridgeline_plot.ipynb"/>
     <var name="nb-sampling_pick" value="%nbviewer_cookbook%/sampling_pick.ipynb"/>
     <var name="nb-sampling_stratified" value="%nbviewer_cookbook%/sampling_stratified.ipynb"/>
+    <var name="nb-scale_break_width_datetime" value="%html_cookbook%/scale_break_width_datetime.html"/>
+    <var name="nb-scale_break_width_duration" value="%html_cookbook%/scale_break_width_duration.html"/>
+    <var name="nb-scale_break_width_log10" value="%html_cookbook%/scale_break_width_log10.html"/>
+    <var name="nb-scale_brewer_overflow" value="%html_cookbook%/scale_brewer_overflow.html"/>
+    <var name="nb-scale_color_palette" value="%html_cookbook%/scale_color_palette.html"/>
     <var name="nb-scale_functions" value="%nbviewer_cookbook%/scale_functions.ipynb"/>
     <var name="nb-scale_time" value="%nbviewer_cookbook%/scale_time.ipynb"/>
     <var name="nb-scatter_plot" value="%nbviewer_cookbook%/scatter_plot.ipynb"/>
     <var name="nb-set_font_faces" value="%nbviewer_cookbook%/set_font_faces.ipynb"/>
+    <var name="nb-smooth_summary" value="%html_cookbook%/smooth_summary.html"/>
     <var name="nb-stat_boxplot_outlier" value="%nbviewer_cookbook%/stat_boxplot_outlier.ipynb"/>
     <var name="nb-stat_count_2d" value="%nbviewer_cookbook%/stat_count_2d.ipynb"/>
     <var name="nb-stat_ecdf" value="%nbviewer_cookbook%/stat_ecdf.ipynb"/>
diff --git a/devdocs/DOKKA_AND_WRITERSIDE.md b/devdocs/DOKKA_AND_WRITERSIDE.md
index 6c22446af..be2178b96 100644
--- a/devdocs/DOKKA_AND_WRITERSIDE.md
+++ b/devdocs/DOKKA_AND_WRITERSIDE.md
@@ -41,6 +41,10 @@ Now the documentation site can be explored locally with the [http-server](https:
                                      
 See: [Writerside: Configure search](https://www.jetbrains.com/help/writerside/configure-search.html#create-the-build-configuration-on-ci-cd)
 
+> [!IMPORTANT]
+> Always update the Algolia index after rebuilding and publishing the documentation,
+> regardless of the type or scope of the changes.
+
 - For the first run: add the Algolia admin secret API key (`aligola.key=`) to the [local.properties](../local.properties) file.
 
 - Run Bash script:
diff --git a/plot-api/build.gradle.kts b/plot-api/build.gradle.kts
index f7ed02f83..3c7d90463 100644
--- a/plot-api/build.gradle.kts
+++ b/plot-api/build.gradle.kts
@@ -79,11 +79,11 @@ tasks.withType<org.jetbrains.dokka.gradle.DokkaTask>().configureEach {
             suppress.set(true)
         }
         perPackageOption {
-            matchingRegex.set(""".*\.intern.*""")
+            matchingRegex.set(""".*\.intern\..*""")
             suppress.set(true)
         }
         perPackageOption {
-            matchingRegex.set(""".*\.intern\.layer.*""")
+            matchingRegex.set(""".*\.intern\.layer(\..*)?""")
             suppress.set(false)
         }
     }
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/AnnotationOptions.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/AnnotationOptions.kt
index ac8c386b3..2faa2f48a 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/AnnotationOptions.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/AnnotationOptions.kt
@@ -23,12 +23,13 @@ typealias AnnotationOptions = layerLabels
  * contrast: white text appears on darker filled geometries, and black text
  * appears on lighter filled geometries.
  *
- * The text color can be manually specified using:
- * `theme(labelText=elementText(color=...))`
+ * Use `theme(labelText = elementText(color = ...))` to customize the appearance of annotation text.
+ * See also [elementText()][org.jetbrains.letsPlot.themes.elementText].
  *
- * Alternatively, the [inheritColor()][org.jetbrains.letsPlot.annotations.layerLabels.inheritColor] method can be used to override both
- * automatic and manual color settings, making the annotation text use the
- * geometry's `color` aesthetic instead.
+ * Alternatively, the [inheritColor()][org.jetbrains.letsPlot.annotations.layerLabels.inheritColor]
+ * method can be used to make annotation text use the geometry's `color` aesthetic,
+ * overriding both the automatically selected text color and any color specified via
+ * `theme(labelText = elementText(color = ...))`.
  *
  * ## Examples
  *
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/SmoothLabels.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/SmoothLabels.kt
index b2caecc22..008ce72a1 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/SmoothLabels.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/annotations/SmoothLabels.kt
@@ -8,40 +8,51 @@ package org.jetbrains.letsPlot.annotations
 import org.jetbrains.letsPlot.core.spec.Option
 
 /**
- * Configure annotations for `geomSmooth()` layers.
+ * Configure annotations for [geomSmooth()][org.jetbrains.letsPlot.geom.geomSmooth] layers.
  *
- * `smoothLabels()` is a specialized annotation helper designed for smooth layers.
- * It shares the same API as [layerLabels] — supporting [line], [format], [size], and [inheritColor] —
- * and additionally provides regression-specific methods: [eq], [labelX], and [labelY].
+ * This class extends [layerLabels()][org.jetbrains.letsPlot.annotations.layerLabels]
+ * and provides additional options for displaying statistics produced by the `smooth` stat, such as
+ * R², adjusted R², and the fitted model equation.
+ *
+ * It allows placing a multi-line annotation near the smooth curve and
+ * mixing custom text, computed variables (e.g. `..r2..`), and a generated
+ * equation block.
+ * If created without any additional configuration the annotation displays a single line with R².
  *
  * ## Supported variables and markers
  *
- * Use these in [line] templates via `@..name..` syntax:
+ * Use these in [line()][org.jetbrains.letsPlot.annotations.smoothLabels.line] templates via `@..name..` syntax:
  *
- * - `..r2..` — R² (coefficient of determination).
- * - `..adjr2..` — adjusted R².
- * - `..aic..` — Akaike Information Criterion.
- * - `..bic..` — Bayesian Information Criterion.
- * - `..f..` — F-statistic.
- * - `..df1..` — numerator degrees of freedom for the F-test.
- * - `..df2..` — denominator degrees of freedom for the F-test.
- * - `..p..` — p-value for the overall model F-test.
- * - `..method..` — smoothing method label (`lm` or `loess`).
- * - `..n..` — number of observations used in model fitting.
- * - `..cilevel..` — confidence level used for the R² confidence interval.
- * - `..cilow..` — lower bound of the R² confidence interval.
- * - `..cihigh..` — upper bound of the R² confidence interval.
- * - `~eq` — fitted equation (use in a [line] template to insert the model equation).
+ * - `..r2..` - R² (coefficient of determination).
+ * - `..adjr2..` - adjusted R².
+ * - `..aic..` - Akaike Information Criterion.
+ * - `..bic..` - Bayesian Information Criterion.
+ * - `..f..` - F-statistic.
+ * - `..df1..` - numerator degrees of freedom for the F-test.
+ * - `..df2..` - denominator degrees of freedom for the F-test.
+ * - `..p..` - p-value for the overall model F-test.
+ * - `..method..` - smoothing method label (`lm` or `loess`).
+ * - `..n..` - number of observations used in model fitting.
+ * - `..cilevel..` - confidence level used for the R² confidence interval.
+ * - `..cilow..` - lower bound of the R² confidence interval.
+ * - `..cihigh..` - upper bound of the R² confidence interval.
+ * - `~eq` - fitted equation (use in a [line()][org.jetbrains.letsPlot.annotations.smoothLabels.line] template to insert the model equation).
  *
  * ## Notes
  *
- * The text color can be set using: `theme(labelText=elementText(color=...))`.
+ * By default, annotation text color is automatically selected for good readability.
+ *
+ * Use `theme(labelText = elementText(...))` to customize the appearance of annotation text.
+ * See also [elementText()][org.jetbrains.letsPlot.themes.elementText].
  *
- * Alternatively, [inheritColor] makes the annotation text use the geometry's `color` aesthetic.
+ * Alternatively, the [inheritColor()][org.jetbrains.letsPlot.annotations.smoothLabels.inheritColor]
+ * method can be used to make annotation text use the geometry's `color` aesthetic,
+ * overriding both the automatically selected text color and any color specified via
+ * `theme(labelText = elementText(...))`.
  *
  * ## Examples
  *
- * - [smooth_summary.ipynb](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.13.0/smooth_summary.html)
+ * - [smooth_summary.html](https://lets-plot.org/kotlin/examples/cookbook/smooth_summary.html)
  *
  * ```kotlin
  * val data = mapOf("x" to listOf(0, 1.5, 1.7, 2), "y" to listOf(0, 1, 1.8, 4))
@@ -119,8 +130,8 @@ class smoothLabels {
      * Specifies a line template to show in the annotation.
      *
      * Variables can be accessed via `@..name..` syntax:
-     * - `@..r2..` — R² value
-     * - `@..adjr2..` — adjusted R² value
+     * - `@..r2..` - R² value
+     * - `@..adjr2..` - adjusted R² value
      *
      * Use `~eq` as a placeholder for the auto-generated equation.
      *
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/bistro/waterfall/WaterfallPlot.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/bistro/waterfall/WaterfallPlot.kt
index c8dbbd722..af7236e5b 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/bistro/waterfall/WaterfallPlot.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/bistro/waterfall/WaterfallPlot.kt
@@ -99,7 +99,8 @@ package org.jetbrains.letsPlot.bistro.waterfall
  *  Set [elementText()][org.jetbrains.letsPlot.themes.elementText] to specify style parameters.
  *  Use `elementText(color="inherit")` to make labels inherit the color of bar borders.
  * @param labelFormat Format used to transform label mapping values to a string.
- *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html)
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
+ *
  *  Note: the "$" must be escaped as "\$".
  *
  *  Examples:
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket.kt
index 66ef8a4e0..5996be0cf 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket.kt
@@ -17,7 +17,7 @@ import org.jetbrains.letsPlot.tooltips.tooltipsNone
  *
  * ## Examples
  *
- * - [geom_bracket.ipynb](https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/kotlin_examples/cookbook/geom_bracket.ipynb)
+ * - [geom_bracket.html](https://lets-plot.org/kotlin/examples/cookbook/geom_bracket.html)
  *
  * @param data The data to be displayed. If null, the default, the data is inherited
  *  from the plot data as specified in the call to [letsPlot][org.jetbrains.letsPlot.letsPlot].
@@ -41,6 +41,7 @@ import org.jetbrains.letsPlot.tooltips.tooltipsNone
  * @param orientation default = "x" ("x", "y").
  *  Specifies the axis that the geom should run along.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a".
  *  Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge the geometry by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket_dodge.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket_dodge.kt
index eeea379a1..8431d4634 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket_dodge.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_bracket_dodge.kt
@@ -17,7 +17,7 @@ import org.jetbrains.letsPlot.tooltips.tooltipsNone
  *
  * ## Examples
  *
- * - [geom_bracket.ipynb](https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/kotlin_examples/cookbook/geom_bracket.ipynb)
+ * - [geom_bracket.html](https://lets-plot.org/kotlin/examples/cookbook/geom_bracket.html)
  *
  * @param data The data to be displayed. If null, the default, the data is inherited
  *  from the plot data as specified in the call to [letsPlot][org.jetbrains.letsPlot.letsPlot].
@@ -41,6 +41,7 @@ import org.jetbrains.letsPlot.tooltips.tooltipsNone
  * @param orientation default = "x" ("x", "y").
  *  Specifies the axis that the geom should run along.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a".
  *  Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge the geometry by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_imshow.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_imshow.kt
index db107b00c..0e1d5447f 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_imshow.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_imshow.kt
@@ -65,7 +65,7 @@ import org.jetbrains.letsPlot.scale.scaleManual
  * @param colorBy default="paint_c" ("fill", "color", "paint_a", "paint_b", "paint_c").
  *  Define the color-aesthetic used by the legend shown for a greyscale image.
  * @param cguide default = null.
- *  A result of `guideColorbar()` call.
+ *  A result of [guideColorbar()][org.jetbrains.letsPlot.scale.guideColorbar] call.
  *  Use to customize the colorbar for greyscale images.
  *
  * @return Layer object.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label.kt
index 3e36290ed..4935b9e6f 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label.kt
@@ -85,6 +85,7 @@ import org.jetbrains.letsPlot.tooltips.TooltipOptions
  * @param angle Label rotation angle in degrees.
  * @param lineheight Line height multiplier applied to the font size in the case of multi-line text.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a". Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge labels by.
  * @param nudgeY Vertical adjustment to nudge labels by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label_repel.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label_repel.kt
index 11d82c666..500a6624f 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label_repel.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_label_repel.kt
@@ -93,6 +93,7 @@ import org.jetbrains.letsPlot.tooltips.TooltipOptions
  *  For more info see: [aesthetics.html#line-types](https://lets-plot.org/kotlin/aesthetics.html#line-types).
  * @param lineheight Line height multiplier applied to the font size in the case of multi-line text.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a".
  *  Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge labels by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text.kt
index 76cc38cb5..6e16f24bd 100755
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text.kt
@@ -85,6 +85,7 @@ import org.jetbrains.letsPlot.tooltips.TooltipOptions
  * @param angle Text rotation angle in degrees.
  * @param lineheight Line height multiplier applied to the font size in the case of multi-line text.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a".
  *  Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge labels by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text_repel.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text_repel.kt
index e61957865..ada8957bc 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text_repel.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_text_repel.kt
@@ -90,6 +90,7 @@ import org.jetbrains.letsPlot.tooltips.TooltipOptions
  *  For more info see: [aesthetics.html#line-types](https://lets-plot.org/kotlin/aesthetics.html#line-types).
  * @param lineheight Line height multiplier applied to the font size in the case of multi-line text.
  * @param labelFormat Specifies the format pattern for displaying mapped values.
+ *  For more info see: [formats.html](https://lets-plot.org/kotlin/formats.html).
  * @param naText default = "n/a".
  *  Text to show for missing values.
  * @param nudgeX Horizontal adjustment to nudge labels by.
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Core.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Core.kt
index 419f4b2af..097a295cf 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Core.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Core.kt
@@ -16,6 +16,9 @@ import org.jetbrains.letsPlot.intern.layer.SamplingOptions
 import org.jetbrains.letsPlot.intern.layer.StatOptions
 import org.jetbrains.letsPlot.tooltips.TooltipOptions
 
+/**
+ * @suppress
+ */
 class Plot internal constructor(
     val data: Map<*, *>? = null,
     val mapping: Options = GenericAesMapping().seal(),
@@ -71,6 +74,9 @@ class Plot internal constructor(
 }
 
 
+/**
+ * @suppress
+ */
 sealed class Feature {
     /**
      * @suppress
@@ -85,6 +91,9 @@ sealed class Feature {
 }
 
 
+/**
+ * @suppress
+ */
 class FeatureList(elements: List<Feature>) : Feature() {
     val elements: List<Feature> = elements.flatMap { element ->
         when (element) {
@@ -108,6 +117,9 @@ internal object DummyFeature : Feature() {
     }
 }
 
+/**
+ * @suppress
+ */
 abstract class Layer(
     mapping: Options,
     val data: Map<*, *>? = null,
@@ -135,6 +147,9 @@ abstract class Layer(
     }
 }
 
+/**
+ * @suppress
+ */
 open class Scale(
     aesthetic: Any,
     val name: String? = null,
@@ -212,6 +227,9 @@ open class Scale(
     }
 }
 
+/**
+ * @suppress
+ */
 open class OptionsMap internal constructor(
     val kind: String,
     val options: Map<String, Any>
@@ -227,5 +245,8 @@ open class OptionsMap internal constructor(
     )
 }
 
+/**
+ * @suppress
+ */
 abstract class NotLayer : Feature()
 
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GenericAesMapping.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GenericAesMapping.kt
index 8960ceb68..03e97970d 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GenericAesMapping.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GenericAesMapping.kt
@@ -7,6 +7,9 @@ package org.jetbrains.letsPlot.intern
 
 import org.jetbrains.letsPlot.intern.layer.WithGroupOption
 
+/**
+ * @suppress
+ */
 class GenericAesMapping(
     var x: Any? = null,
     var y: Any? = null,
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GeomKind.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GeomKind.kt
index f21f52e54..e4d09cca5 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GeomKind.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/GeomKind.kt
@@ -5,6 +5,9 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 enum class GeomKind {
     BLANK,
     PATH,
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Options.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Options.kt
index 8b51452b3..dc2acebce 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Options.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Options.kt
@@ -7,6 +7,9 @@ package org.jetbrains.letsPlot.intern
 
 import org.jetbrains.letsPlot.intern.standardizing.MapStandardizing
 
+/**
+ * @suppress
+ */
 class Options(map: Map<String, Any?>) {
     companion object {
         fun of(pair: Pair<String, Any?>) = Options(mapOf(pair))
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/OptionsCapsule.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/OptionsCapsule.kt
index e3c51f0e8..634ca0c17 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/OptionsCapsule.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/OptionsCapsule.kt
@@ -5,6 +5,9 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 interface OptionsCapsule {
     /**
      * @suppress
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/PosKind.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/PosKind.kt
index e557f4e14..28bc12114 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/PosKind.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/PosKind.kt
@@ -5,6 +5,9 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 enum class PosKind {
     IDENTITY,
     STACK,
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Preconditions.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Preconditions.kt
index adebd7019..9c84523ee 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Preconditions.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/Preconditions.kt
@@ -5,11 +5,17 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 fun checkScaleExpand(expand: List<Any>?) {
     expand?.let { require(expand.size in (1..2)) { "'expand' must be a list of size 1 or 1: $expand" } }
     expand?.let { require(expand.all { it is Number }) { "'expand' must contain only numbers: $expand" } }
 }
 
+/**
+ * @suppress
+ */
 fun checkGreyScaleStartEnd(start: Number? = null, end: Number? = null) {
     start?.let { require(start.toDouble() in (0.0..1.0)) { "'start' must be in range: [0,1]: $start" } }
     end?.let { require(end.toDouble() in (0.0..1.0)) { "'end' must be in range: [0,1]: $end" } }
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ReflectionPatch.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ReflectionPatch.kt
index 23e6cf12c..2c918da99 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ReflectionPatch.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ReflectionPatch.kt
@@ -9,6 +9,7 @@ package org.jetbrains.letsPlot.intern
  * Patching JS compilation error: Unsupported [This reflection API is not supported yet in JavaScript]
  * Kotlin 1.4
  * ToDo: check Kotlin 1.5
+ * @suppress
  */
 expect object ReflectionPatch {
     fun simpleName(o: Any): String?
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/SamplingKind.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/SamplingKind.kt
index a4dc9d757..35094aaa5 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/SamplingKind.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/SamplingKind.kt
@@ -5,6 +5,9 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 enum class SamplingKind {
     NONE,
     RANDOM,
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/StatKind.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/StatKind.kt
index 62f85c05d..7d5db9df2 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/StatKind.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/StatKind.kt
@@ -5,6 +5,9 @@
 
 package org.jetbrains.letsPlot.intern
 
+/**
+ * @suppress
+ */
 enum class StatKind {
     IDENTITY,
     COUNT,
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ToSpecConverters.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ToSpecConverters.kt
index d2d26737a..9af7302d2 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ToSpecConverters.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/ToSpecConverters.kt
@@ -38,6 +38,9 @@ import org.jetbrains.letsPlot.spatial.GeometryFormat
 import org.jetbrains.letsPlot.spatial.SpatialDataset
 import kotlin.reflect.KClass
 
+/**
+ * @suppress
+ */
 fun Figure.toSpec(): MutableMap<String, Any> {
     return when (this) {
         is Plot -> this.toSpec()
@@ -46,6 +49,9 @@ fun Figure.toSpec(): MutableMap<String, Any> {
     }
 }
 
+/**
+ * @suppress
+ */
 fun Plot.toSpec(): MutableMap<String, Any> {
     val spec = HashMap<String, Any>()
     val plot = this
@@ -102,6 +108,9 @@ fun Plot.toSpec(): MutableMap<String, Any> {
     return spec
 }
 
+/**
+ * @suppress
+ */
 fun Layer.toSpec(): MutableMap<String, Any> {
     val spec = HashMap<String, Any>()
 
@@ -225,12 +234,18 @@ private fun Layer.beforeAsPlotData(rawData: Map<*, *>): Map<*, *> {
 }
 
 
+/**
+ * @suppress
+ */
 @Suppress("UNCHECKED_CAST")
 fun Map<String, Any?>.filterNonNullValues(): Map<String, Any> {
     return filter { it.value != null } as Map<String, Any>
 }
 
 
+/**
+ * @suppress
+ */
 fun Scale.toSpec(): List<Map<String, Any>> {
     val spec = HashMap<String, Any>()
 
@@ -253,6 +268,9 @@ fun Scale.toSpec(): List<Map<String, Any>> {
     }
 }
 
+/**
+ * @suppress
+ */
 fun OptionsMap.toSpec(): MutableMap<String, Any> {
     return HashMap(
         MapStandardizing.standardize(options)
diff --git a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/themes/theme.kt b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/themes/theme.kt
index 365eaeeab..b30221a47 100644
--- a/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/themes/theme.kt
+++ b/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/themes/theme.kt
@@ -206,11 +206,11 @@ import org.jetbrains.letsPlot.intern.filterNonNullValues
  * @param stripTextX Style settings for horizontal facet labels.
  * @param stripTextY Style settings for vertical facet labels.
  * @param stripSpacing Spacing between facet labels and the plotting area.
- * @param stripSpacingX Spacing between facet labels and the plotting area in horizontal direction, inherited from ``stripSpacing``.
- * @param stripSpacingY Spacing between facet labels and the plotting area in vertical direction, inherited from ``stripSpacing``.
+ * @param stripSpacingX Spacing between facet labels and the plotting area in horizontal direction, inherited from `stripSpacing`.
+ * @param stripSpacingY Spacing between facet labels and the plotting area in vertical direction, inherited from `stripSpacing`.
  * @param panelSpacing Spacing between panels in facets.
- * @param panelSpacingX Spacing between panels in facets in horizontal direction, inherited from ``panelSpacing``.
- * @param panelSpacingY Spacing between panels in facets in vertical direction, inherited from ``panelSpacing``.
+ * @param panelSpacingX Spacing between panels in facets in horizontal direction, inherited from `panelSpacing`.
+ * @param panelSpacingY Spacing between panels in facets in vertical direction, inherited from `panelSpacing`.
  *
  * @param axisTooltip Style settings for axes tooltips.
  * @param axisTooltipX Style settings for axes tooltips.
@@ -225,10 +225,11 @@ import org.jetbrains.letsPlot.intern.filterNonNullValues
  * @param tooltipTitleText Style settings for tooltip title text.
  *
  * @param labelText Style settings for annotation text.
- *  Annotations are currently supported for pie and bar charts.
- *  Set `elementText()` to specify annotation text parameters: font family and face, text size,
- *  text color (relevant for a pie chart - for those annotations that are outside the pie).
- *
+ *  Applies to text labels used in annotations, including labels configured with
+ *  [layerLabels()][org.jetbrains.letsPlot.annotations.layerLabels] and
+ *  [smoothLabels()][org.jetbrains.letsPlot.annotations.smoothLabels].
+ *  For more info see [annotations.html](https://lets-plot.org/kotlin/annotations.html).
+ *  Set [elementText()][org.jetbrains.letsPlot.themes.elementText] to specify label text appearance.
  * @param geom Color settings for geometries.
  */
 @Suppress("ClassName")
@@ -576,7 +577,7 @@ class theme(
 }
 
 /**
- * Theme element that draws nothing and allocates no space for non-data components of the plot.
+ * Theme element that specifies that the corresponding non-data components of the plot are not drawn and do not allocate space.
  *
  * ## Examples
  *
@@ -586,7 +587,7 @@ fun elementBlank() = mapOf(Option.Theme.Elem.BLANK to true)
 
 
 /**
- * Theme element that draws rectangular non-data components of the plot: borders and backgrounds.
+ * Theme element that specifies how rectangular non-data components of the plot, such as borders and backgrounds, are drawn.
  *
  * ## Examples
  *
@@ -617,7 +618,7 @@ fun elementRect(
 
 
 /**
- * Theme element that draws line-based non-data components of the plot.
+ * Theme element that specifies how line-based non-data components of the plot are drawn.
  *
  * ## Examples
  *
@@ -645,7 +646,7 @@ fun elementLine(
 
 
 /**
- * Theme element that draws text for non-data components of the plot.
+ * Theme element that specifies how text in non-data components of the plot is drawn.
  *
  * ## Examples
  *
@@ -702,7 +703,7 @@ fun elementText(
 
 
 /**
- * Theme element that draws text with Markdown support for non-data components of the plot.
+ * Theme element that specifies how text with Markdown support in non-data components of the plot is drawn.
  *
  * Supported features:
  *
diff --git a/plot-api/src/jvmMain/kotlin/org/jetbrains/letsPlot/intern/PlotSpecUtil.kt b/plot-api/src/jvmMain/kotlin/org/jetbrains/letsPlot/intern/PlotSpecUtil.kt
index 57e365a17..e750f6f64 100644
--- a/plot-api/src/jvmMain/kotlin/org/jetbrains/letsPlot/intern/PlotSpecUtil.kt
+++ b/plot-api/src/jvmMain/kotlin/org/jetbrains/letsPlot/intern/PlotSpecUtil.kt
@@ -10,6 +10,7 @@ import org.jetbrains.letsPlot.commons.intern.json.JsonSupport
 
 /**
  * Used in IDEA Plugin
+ * @suppress
  */
 @Suppress("unused")
 object PlotSpecUtil {