Rework library introduction

CHANGELOG.md

@@ -13,17 +13,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Notebook `feature_selection` ([#875](https://github.com/tinkoff-ai/etna/pull/875))
 - 
 - Implementation of PatchTS model ([#1277](https://github.com/tinkoff-ai/etna/pull/1277))
+- Add `quickstart` notebook, add `mechanics_of_forecasting` notebook ([#1343](https://github.com/tinkoff-ai/etna/pull/1343))
 
 ### Changed
 - 
 - Add installation page and notes about extensions into documentation of public classes ([#1339](https://github.com/tinkoff-ai/etna/pull/1339))
 - Unify errors, warnings and checks in models ([#1312](https://github.com/tinkoff-ai/etna/pull/1312))
 - Merge User Guide and API sections in documentation, limit classes to show in API section ([#1324](https://github.com/tinkoff-ai/etna/pull/1324))
 - Unify example notebooks, rerun example notebooks ([#1330](https://github.com/tinkoff-ai/etna/pull/1330))
+- Rework `get_started` notebook ([#1343](https://github.com/tinkoff-ai/etna/pull/1343))
 
 ### Fixed
 - 
-- 
+- Rendering table of contents in notebooks ([#1343](https://github.com/tinkoff-ai/etna/pull/1343))
 - 
 - `mrmr` feature selection working with categoricals ([#1311](https://github.com/tinkoff-ai/etna/pull/1311))
 - Fix version of `statsforecast` to 1.4 to avoid dependency conflicts during installation ([#1313](https://github.com/tinkoff-ai/etna/pull/1313))

README.md

@@ -45,7 +45,7 @@ The library started as an internal product in our company -
 we use it in over 10+ projects now, so we often release updates. 
 Contributions are welcome - check our [Contribution Guide](https://github.com/tinkoff-ai/etna/blob/master/CONTRIBUTING.md).
 
-## Get started
+## Quickstart
 
 Let's load and prepare the data.
 ```python
@@ -116,17 +116,23 @@ from etna.analysis import plot_forecast
 plot_forecast(forecast_ts=forecast_ts, test_ts=test_ts, train_ts=train_ts, n_train_samples=50)
 ```
 
-![](examples/assets/readme/get_started.png)
+![](examples/assets/readme/quickstart.png)
 
 Print the metric value across the segments:
 ```python
 from etna.metrics import SMAPE
 
-metric = SMAPE(mode="macro")
+metric = SMAPE()
 metric_value = metric(y_true=test_ts, y_pred=forecast_ts)
->>> {'segment_b': 3.3017151519000967, 'segment_c': 5.270557433427279, 'segment_a': 5.272811627335398, 'segment_d': 4.689085450895735}
+metric_value
 ```
 
+```bash
+{'segment_a': 4.799114474387907, 'segment_b': 3.271014290441896, 'segment_c': 6.758606238307858, 'segment_d': 4.512871862697337}
+```
+
+Notebook with this example is available [here](examples/quickstart.ipynb).
+
 ## Installation 
 
 ETNA is available on [PyPI](https://pypi.org/project/etna), so you can use `pip` to install it.
@@ -189,6 +195,7 @@ We have also prepared a set of tutorials for an easy introduction:
 | [Hierarchical time series](https://github.com/tinkoff-ai/etna/blob/master/examples/14-hierarchical_pipeline.ipynb)          |      [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/tinkoff-ai/etna/master?filepath=examples/14-hierarchical_pipeline.ipynb) |
 | [Classification](https://github.com/tinkoff-ai/etna/blob/master/examples/15-classification.ipynb)                           |             [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/tinkoff-ai/etna/master?filepath=examples/15-classification.ipynb) |
 | [Feature selection](https://github.com/tinkoff-ai/etna/blob/master/examples/16-feature_selection.ipynb)                     |          [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/tinkoff-ai/etna/master?filepath=examples/16-feature_selection.ipynb) |
+| [Mechanics of forecasting](https://github.com/tinkoff-ai/etna/blob/master/examples/17-mechanics_of_forecasting.ipynb)       |          [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/tinkoff-ai/etna/master?filepath=examples/17-mechanics_of_forecasting.ipynb) |
 
 ## Documentation
 

docs/Makefile

@@ -22,6 +22,7 @@ clean:
 copy-tutorials:
 	@mkdir -p "$(SOURCEDIR)/tutorials"
 	@cp ../examples/*.ipynb "$(SOURCEDIR)/tutorials"
+	@cp -r ../examples/assets "$(SOURCEDIR)/tutorials/assets"
 
 html:
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/source/index.rst

@@ -20,5 +20,6 @@ Contents
    :titlesonly:
 
    installation
+   tutorials/quickstart
    tutorials
    api_reference

docs/source/tutorials.rst

@@ -23,3 +23,4 @@ Tutorials
    tutorials/14-hierarchical_pipeline
    tutorials/15-classification
    tutorials/16-feature_selection
+   tutorials/17-mechanics_of_forecasting