Adds future documentation placeholders, warnings in legacy guides

Author: spjuhel

doc/user-guide/adaptation.rst

@@ -0,0 +1,14 @@
+==========================
+Adapation appraisal guides
+==========================
+
+These guides show everything you need to know in order to evaluate adapation options with CLIMADA.
+
+.. toctree::
+    :maxdepth: 1
+
+    .. Adaptation measures in CLIMADA <climada_measures.ipynb>
+    Using measure configurations <climada_measure_config.ipynb>
+    .. Defining measure cash flows <climada_cost_income.ipynb>
+    .. Cost benefit evaluation <climada_cost_benefit.ipynb>
+    .. Adapation planning evaluation <climada_planning_evaluation.ipynb>

doc/user-guide/climada_engine_CostBenefit.ipynb

@@ -7,6 +7,15 @@
     "# END-TO-END COST BENEFIT CALCULATION"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "```{attention}\n",
+    "Adapation measures and cost-benefit evaluation are being completely revamped. Associated tutorials will be under their own menu \"Adaptation appraisal guides\"\n",
+    "```"
+   ]
+  },
   {
    "attachments": {},
    "cell_type": "markdown",
@@ -1286,9 +1295,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "Python [conda env:climada_env_dev]",
    "language": "python",
-   "name": "python3"
+   "name": "conda-env-climada_env_dev-py"
   },
   "language_info": {
    "codemirror_mode": {
@@ -1300,7 +1309,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.10"
+   "version": "3.11.15"
   },
   "latex_envs": {
    "LaTeX_envs_menu_present": true,

doc/user-guide/climada_entity_MeasureSet.ipynb

@@ -6,7 +6,11 @@
    "source": [
     "# Adaptation Measures\n",
     "\n",
-    "Adaptation measures are defined by parameters that alter the exposures, hazard or impact functions. Risk transfer options are also considered. Single measures are defined in the `Measure` class, which can be aggregated to a `MeasureSet`."
+    "Adaptation measures are defined by parameters that alter the exposures, hazard or impact functions. Risk transfer options are also considered. Single measures are defined in the `Measure` class, which can be aggregated to a `MeasureSet`.\n",
+    "\n",
+    "```{attention}\n",
+    "Adapation measures and cost-benefit evaluation are being completely revamped. Associated tutorials will be under their own menu \"Adaptation appraisal guides\".\n",
+    "```"
    ]
   },
   {

doc/user-guide/index.rst

@@ -19,6 +19,7 @@ You can then go on to more specific tutorial about `Hazard <hazard.html>`_,
    Hazard <hazard>
    Exposures <exposures>
    Impact <impact>
+   Adaptation appraisal <adaptation>
    Local exceedance intensities <climada_util_local_exceedance_values>
    Uncertainty Quantification <unsequa>
    climada_engine_Forecast