docs: add overview page

docs/diplodoc/index.yaml

@@ -4,6 +4,8 @@ meta:
   title: Gravity UI Charts
   noIndex: true
 links:
+  - title: Overview
+    href: ./pages/overview.md
   - title: Get started
     href: ./pages/get-started.md
   - title: API

docs/diplodoc/pages/get-started.md

@@ -1,12 +1,12 @@
-## Get started
+# Get started
 
-### Install
+## Install
 
 ```shell
 npm install @gravity-ui/uikit @gravity-ui/charts
 ```
 
-### Development
+## Development
 
 To start the development server with storybook run the following:
 

docs/diplodoc/pages/overview.md

@@ -0,0 +1,43 @@
+# Overview
+
+## About Gravity UI Charts
+
+**Gravity UI Charts** is a charting library built with [D3](https://d3js.org/) and [React](https://react.dev/). It's designed as part of the [Gravity UI](https://gravity-ui.com/) ecosystem and provides powerful data visualization capabilities for modern web applications through simple configuration objects.
+
+{% note warning %}
+
+While the library is in version `0.*.*`, minor releases may include incompatible changes to the API.
+
+{% endnote %}
+
+## What you can already do with Gravity UI Charts
+
+We have already implemented support for the main chart types:
+
+- `Area`
+- `Bar-X`
+- `Bar-Y`
+- `Line`
+- `Pie`
+- `Scatter`
+- `Treemap` (partial support)
+- `Waterfall` (partial support)
+
+{% cut "Examples from Storybook" %}
+
+<iframe
+    src="https://preview.gravity-ui.com/charts/iframe.html?args=&globals=&id=showcase--d-3-showcase-story&viewMode=story"
+    width="100%"
+    height="400"
+    ></iframe>
+
+{% endcut %}
+
+## Roadmap
+
+We are actively working on library development and continuously improving its features. Here is the list of the priority major features:
+
+- ⏳ Handling null data [#28](https://github.com/gravity-ui/charts/issues/28)
+- ⏳ Charts zooming [#29](https://github.com/gravity-ui/charts/issues/29)
+- ⏳ Plot lines, bands [#30](https://github.com/gravity-ui/charts/issues/30)
+- ⏳ Charts navigator [#35](https://github.com/gravity-ui/charts/issues/35)

docs/diplodoc/toc.yaml

@@ -10,10 +10,16 @@ navigation:
       icon: https://storage.yandexcloud.net/gravity-ui-assets/gravity-logo-light.svg
       text: Charts
   header:
+    leftItems:
+      - text: Github ➚
+        type: link
+        url: https://github.com/gravity-ui/charts
     rightItems:
       - type: controls
       - type: search
 items:
+  - name: Overview
+    href: ./pages/overview.md
   - name: Get started
     href: ./pages/get-started.md
   - name: API

docs/gulpfile.docs.js

@@ -25,7 +25,7 @@ function reload(cb) {
 }
 
 function watchFiles() {
-    watch(['./docs/diplodoc/**/*', './docs/src/**/*', '../src/**/*'], series(build, reload));
+    watch(['./diplodoc/**/*', './src/**/*', '../src/**/*'], series(build, reload));
 }
 
 exports.default = series(build, parallel(serve, watchFiles));