very early draft migration guide

Author: OriolAbril

doc/source/api/preview.md

@@ -1,11 +1,23 @@
 (preview_api)=
 
 # Preview
-This module give access to upcoming refactored features by exposing
+
+:::{py:module} arviz.preview
+This module gives access to upcoming refactored features by exposing
 all objects in [arviz-base](https://arviz-base.readthedocs.io/en/latest/),
 [arviz-stats](https://arviz-stats.readthedocs.io/en/latest/) and
 [arviz-plots](https://arviz-plots.readthedocs.io/en/latest/)
 under a single namespace: `arviz.preview`.
 
 In addition, there is also an `arviz.preview.info` to check availability
 of the different sub-libraries.
+:::
+
+
+:::{seealso}
+* Introduction to Exploratory Analysis of Bayesian Models and Bayesian workflow
+  through [arviz.preview](https://arviz-devs.github.io/EABM/)
+* The {ref}`migration_guide` introduces the new arviz-xyz libraries through
+  ``arviz.preview`` focusing on the differences with current ArviZ,
+  the reasons behind them and what new features can be unlocked through these changes.
+:::

doc/source/getting_started/Installation.rst

@@ -7,6 +7,20 @@ functionality is available with the basic requirements, but ArviZ also has optio
 dependencies to further enhance the library. This guide will cover both basic and fully-fledged ArviZ installs and several installation methods.
 
 
+.. tip::
+
+   If you are installing ArviZ for the first time, consider installing with
+
+   .. code:: bash
+
+      pip install "arviz[preview]"
+
+   And using the library through the {mod}`arviz.preview` module.
+   There are still some features present in ``arviz.`` not available
+   in ``arviz.preview.``, but most already are and there are also
+   some new ones that are not available in ``arviz.`` (and won't ever be).
+
+
 ******
 Stable
 ******