From f497c71d4a27a745c78525e5b84e6dd01bd606e3 Mon Sep 17 00:00:00 2001
From: Guillaume Genestier <guillaume.genestier@lambda-coins.com>
Date: Thu, 23 Jan 2025 09:45:51 +0100
Subject: [PATCH] Doc: Add documentation about --without-dal

---
 docs/introduction/breaking_changes.rst | 13 +++++++++++++
 docs/introduction/howtorun.rst         |  3 ++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/introduction/breaking_changes.rst b/docs/introduction/breaking_changes.rst
index fc203793eb6f..657d7c1bf80d 100644
--- a/docs/introduction/breaking_changes.rst
+++ b/docs/introduction/breaking_changes.rst
@@ -147,3 +147,16 @@ As a consequence, `inspecting this Ghostnet contract <https://rpc.ghostnet.teztn
         },
         ...
     ]
+
+Upcoming changes
+================
+
+Baker: Explicit choice on using DAL or not via the CLI
+------------------------------------------------------
+
+Octez ``v21.3`` introduces the new ``--without-dal`` option for the baker daemon.
+In Octez ``v21.3``, this option is not mandatory and will only trigger a warning.
+
+Starting from Octez ``v22``, launching a baker daemon requires an explicit mention of the DAL.
+The recommended approach is to run a DAL node and start the baker using the ``--dal-node <uri>`` option.
+If you do not wish to use a DAL node, you can opt-out by using the ``--without-dal`` option.
diff --git a/docs/introduction/howtorun.rst b/docs/introduction/howtorun.rst
index 26f2f138cd3a..837830c86d00 100644
--- a/docs/introduction/howtorun.rst
+++ b/docs/introduction/howtorun.rst
@@ -214,7 +214,7 @@ accounts have the necessary rights.
 Let's launch the daemon pointing to the standard node directory and
 baking for user *bob*::
 
-   octez-baker-<PROTO_HASH> run with local node ~/.tezos-node bob --liquidity-baking-toggle-vote pass
+   octez-baker-<PROTO_HASH> run with local node ~/.tezos-node bob --liquidity-baking-toggle-vote pass --without-dal
 
 where ``PROTO_HASH`` is the short hash of the current protocol of the network you want to bake on.
 
@@ -223,6 +223,7 @@ the node data directory for performance reasons (to reduce the number of RPC cal
 Note also that since version 13.0, option ``--liquidity-baking-toggle-vote`` is mandatory, see :ref:`the changelog <changes_13_0_rc1_baker>`.
 Note that ``--liquidity-baking-toggle-vote`` must be placed
 **after** ``run`` on the command-line.
+Note that option ``--without-dal`` exists since version 21.3 and will be mandatory starting from 22.0.
 
 .. warning::
 
-- 
GitLab