From f00dc091deef3c2abd5c336eab0ffa6681596336 Mon Sep 17 00:00:00 2001
From: Matthias Seitz <matthias.seitz@outlook.de>
Date: Thu, 25 May 2023 15:47:37 +0200
Subject: [PATCH] docs: add list of all stages (#2826)

---
 crates/stages/src/pipeline/mod.rs |  4 ++++
 crates/stages/src/sets.rs         | 14 ++++++++++++++
 2 files changed, 18 insertions(+)

diff --git a/crates/stages/src/pipeline/mod.rs b/crates/stages/src/pipeline/mod.rs
index ec81f98046..03ceca4bdc 100644
--- a/crates/stages/src/pipeline/mod.rs
+++ b/crates/stages/src/pipeline/mod.rs
@@ -82,6 +82,10 @@ pub type PipelineWithResult<DB> = (Pipeline<DB>, Result<ControlFlow, PipelineErr
 /// In case of a validation error (as determined by the consensus engine) in one of the stages, the
 /// pipeline will unwind the stages in reverse order of execution. It is also possible to
 /// request an unwind manually (see [Pipeline::unwind]).
+///
+/// # Defaults
+///
+/// The [DefaultStages](crate::sets::DefaultStages) are used to fully sync reth.
 pub struct Pipeline<DB: Database> {
     /// The Database
     db: DB,
diff --git a/crates/stages/src/sets.rs b/crates/stages/src/sets.rs
index 6348daa8a7..ac3297d657 100644
--- a/crates/stages/src/sets.rs
+++ b/crates/stages/src/sets.rs
@@ -61,6 +61,20 @@ use std::sync::Arc;
 /// - [`OnlineStages`]
 /// - [`OfflineStages`]
 /// - [`FinishStage`]
+///
+/// This expands to the following series of stages:
+/// - [`HeaderStage`]
+/// - [`BodyStage`]
+/// - [`SenderRecoveryStage`]
+/// - [`ExecutionStage`]
+/// - [`MerkleStage`] (unwind)
+/// - [`AccountHashingStage`]
+/// - [`StorageHashingStage`]
+/// - [`MerkleStage`] (execution)
+/// - [`TransactionLookupStage`]
+/// - [`IndexStorageHistoryStage`]
+/// - [`IndexAccountHistoryStage`]
+/// - [`FinishStage`]
 #[derive(Debug)]
 pub struct DefaultStages<H, B, EF> {
     /// Configuration for the online stages