Node running section overhaul

README.md

@@ -12,7 +12,7 @@ The following are the only exceptions:
 
 - Contributing to the three troubleshooting pages — [nodes](arbitrum-docs/partials/_troubleshooting-nodes-partial.mdx), [builders](arbitrum-docs/partials/_troubleshooting-building-partial.mdx), and [users](arbitrum-docs/partials/_troubleshooting-users-partial.mdx), as well as the [glossary](arbitrum-docs/partials/_glossary-partial.md) page — requires internal Offchain Labs access. If you'd like to make a suggestion about content on any of those pages, open an [issue ticket](https://github.com/OffchainLabs/arbitrum-docs/issues).
 
-- To request to have your project added to the [3rd party node providers page](arbitrum-docs/build-decentralized-apps/reference/01-node-providers.md), use [this form](https://docs.google.com/forms/d/e/1FAIpQLSc_v8j7sc4ffE6U-lJJyLMdBoIubf7OIhGtCqvK3cGPGoLr7w/viewform).
+- To request to have your project added to the [3rd party node providers page](arbitrum-docs/build-decentralized-apps/reference/01-node-providers.mdx), use [this form](https://docs.google.com/forms/d/e/1FAIpQLSc_v8j7sc4ffE6U-lJJyLMdBoIubf7OIhGtCqvK3cGPGoLr7w/viewform).
 
 ### Initial set up
 

arbitrum-docs/launch-arbitrum-chain/04-maintain-your-chain/05-upgrade-to-bold.mdx

@@ -32,8 +32,8 @@ Before updating the contracts, you want to make sure your nodes are ready for th
 Most of the parameters used in Nitro before v3.5.4 will stay the same when running a higher version but, depending on the type of node, you'll have to include a few more BoLD-specific parameters after the upgrade:
 
 - For validator nodes: add `--node.bold.strategy=<MakeNodes | ResolveNodes | Defensive>` to configure the validator to create and/or confirm assertions in the new Rollup contract (find more information in [How to run a validator](/run-arbitrum-node/more-types/02-run-validator-node.mdx#step-1-configure-and-run-your-validator))
-- For all other types of node before Nitro v3.6.0: add `--node.bold.enable=true` to enable [watchtower mode](/run-arbitrum-node/03-run-full-node.mdx#watchtower-mode)
-- For all other types of node after Nitro v3.6.0: [watchtower mode](/run-arbitrum-node/03-run-full-node.mdx#watchtower-mode) is automatically enabled
+- For all other types of node before Nitro v3.6.0: add `--node.bold.enable=true` to enable [watchtower mode](/run-arbitrum-node/02-run-full-node.mdx#watchtower-mode)
+- For all other types of node after Nitro v3.6.0: [watchtower mode](/run-arbitrum-node/02-run-full-node.mdx#watchtower-mode) is automatically enabled
 
 Additionally, after performing the upgrade, the `--chain.info-json` object also needs to be modified:
 
@@ -186,8 +186,8 @@ execute(...) call to upgrade executor: 0x1cff79cd000000000000000000000000f8199ca
 As stated at the beginning, you need to add a few parameters to your node configuration for it to support BoLD:
 
 - For validator nodes: add `--node.bold.strategy=<MakeNodes | ResolveNodes | Defensive>` to configure the validator to create and/or confirm assertions in the new Rollup contract (find more information in [How to run a validator](/run-arbitrum-node/more-types/02-run-validator-node.mdx#step-1-configure-and-run-your-validator))
-- For all other types of node before Nitro v3.6.0: add `--node.bold.enable=true` to enable [watchtower mode](/run-arbitrum-node/03-run-full-node.mdx#watchtower-mode)
-- For all other types of node after Nitro v3.6.0: [watchtower mode](/run-arbitrum-node/03-run-full-node.mdx#watchtower-mode) is automatically enabled
+- For all other types of node before Nitro v3.6.0: add `--node.bold.enable=true` to enable [watchtower mode](/run-arbitrum-node/02-run-full-node.mdx#watchtower-mode)
+- For all other types of node after Nitro v3.6.0: [watchtower mode](/run-arbitrum-node/02-run-full-node.mdx#watchtower-mode) is automatically enabled
 
 Additionally, the `--chain.info-json` object also needs to be modified:
 

arbitrum-docs/launch-arbitrum-chain/05-customize-your-chain/customize-stf.mdx

@@ -139,7 +139,7 @@ docker run --rm -it -v /path/to/your/node/dir:/home/user/.arbitrum -p 0.0.0.0:84
 
 :::info
 
-The instructions provided in [How to run a full node](/run-arbitrum-node/03-run-full-node.mdx) **will not** work with your Arbitrum chain node. See [Optional parameters (Arbitrum chain)](/run-arbitrum-node/03-run-full-node.mdx#optional-parameters) for Arbitrum chain (Orbit)-specific CLI flags.
+The instructions provided in [How to run a full node](/run-arbitrum-node/02-run-full-node.mdx) **will not** work with your Arbitrum chain node. See [Optional parameters (Arbitrum chain)](/run-arbitrum-node/02-run-full-node.mdx#optional-parameters) for Arbitrum chain (Orbit)-specific CLI flags.
 
 :::
 

arbitrum-docs/launch-arbitrum-chain/how-tos/arbitrum-chain-sdk-preparing-node-config.md

@@ -156,4 +156,4 @@ After generating the node configuration object, it can be saved to a file for la
 
 ### 3. Next step
 
-You can now run the Nitro node for your Arbitrum chain with the node configuration generated. You can find instructions for running a node in [How to run a full node](/run-arbitrum-node/03-run-full-node.mdx).
+You can now run the Nitro node for your Arbitrum chain with the node configuration generated. You can find instructions for running a node in [How to run a full node](/run-arbitrum-node/02-run-full-node.mdx).

arbitrum-docs/node-running/node-running-content-map.mdx

@@ -0,0 +1,98 @@
+---
+id: node-running-content-map
+title: Run an Arbitrum node
+sidebar_label: Run an Arbitrum node
+---
+
+import Card from '@site/src/components/Cards/Card';
+
+# Run an Arbitrum node
+
+Learn how to run an Arbitrum node.
+
+<div
+  style={{
+    display: 'grid',
+    gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))',
+    gap: '20px',
+  }}
+>
+  <Card
+    title="What node should I run?"
+    description="Overview of node types"
+    href="/run-arbitrum-node/overview"
+    target="_blank"
+  />
+  <Card
+    title="Run a full node"
+    description="Installation and configuration"
+    href="/run-arbitrum-node/run-full-node"
+    target="_blank"
+  />
+  <Card
+    title="Run a local dev node"
+    description="Installation and configuration"
+    href="/run-arbitrum-node/run-nitro-dev-node"
+    target="_blank"
+  />
+  <Card
+    title="Run a validator node"
+    description="Installation and configuration"
+    href="/run-arbitrum-node/more-types/run-validator-node"
+    target="_blank"
+  />
+  <Card
+    title="Data Availability Committees"
+    description="Setup an Arbitrum chain AnyTrust node"
+    href="/run-arbitrum-node/data-availability-committees/get-started"
+    target="_blank"
+  />
+  <Card
+    title="Run an archive node"
+    description="Installation and configuration"
+    href="/run-arbitrum-node/more-types/run-archive-node"
+    target="_blank"
+  />
+  <Card
+    title="Run a Classic node"
+    description="Installation and configuration"
+    href="/run-arbitrum-node/more-types/run-classic-node"
+    target="_blank"
+  />
+  <Card
+    title="Sequencer"
+    description="Keep your node in sync with the sequencer"
+    href="/node-running/sequencer-content-map"
+    target="_blank"
+  />
+  <Card
+    title="Use a node provider"
+    description="Infrastructure node list"
+    href="/build-decentralized-apps/reference/node-providers"
+    target="_blank"
+  />
+  <Card
+    title="Beacon Chain RPC providers"
+    description="Beacon Chain provider list"
+    href="/run-arbitrum-node/l1-ethereum-beacon-chain-rpc-providers"
+    target="_blank"
+  />
+  <Card
+    title="ArbOS software releases"
+    description="ArbOS release list"
+    href="/run-arbitrum-node/arbos-releases/overview"
+    target="_blank"
+  />
+  <Card
+    title="Troubleshooting"
+    description="Common issues and solutions"
+    href="/run-arbitrum-node/troubleshooting"
+    target="_blank"
+  />
+  <Card
+    title="FAQ"
+    description="Frequently asked questions"
+    href="/node-running/faq"
+    target="_blank"
+  />
+</div>

arbitrum-docs/node-running/sequencer-content-map.mdx

@@ -0,0 +1,38 @@
+---
+id: sequencer-content-map
+title: Sequencer
+sidebar_label: Sequencer
+---
+
+import Card from '@site/src/components/Cards/Card';
+
+# Sequencer
+
+Keep your node in sync with the sequencer.
+
+<div
+  style={{
+    display: 'grid',
+    gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))',
+    gap: '20px',
+  }}
+>
+  <Card
+    title="Run a feed relay"
+    description="Installation and configuration."
+    href="/run-arbitrum-node/sequencer/run-feed-relay"
+    target="_blank"
+  />
+  <Card
+    title="Read the sequencer feed"
+    description="Installation and configuration."
+    href="/run-arbitrum-node/sequencer/read-sequencer-feed"
+    target="_blank"
+  />
+  <Card
+    title="Run a Sequencer Coordination Manager (SQM)"
+    description="Installation and configuration."
+    href="/run-arbitrum-node/sequencer/run-sequencer-coordination-manager"
+    target="_blank"
+  />
+</div>

arbitrum-docs/run-arbitrum-node/01-overview.mdx

@@ -1,18 +1,71 @@
 ---
-title: 'Arbitrum nodes overview'
-description: "Arbitrum is a suite of Ethereum L2 scaling solutions supported by a decentralized network of nodes. This guide introduces you to Arbitrum's node types and how they work together to scale Ethereum."
-author: mahsamoosavi
+title: 'Arbitrum nodes: an overview'
+description: Learn more about what type of ARb node one needs to run.
+author-objective: Build a quickstart that helps readers understand why they might want to run a specific type of an Arbitrum node.
+reader-audience: Moderately-technical readers who are familiar with command lines, but not Ethereum / Arbitrum infrastructure
+reader-task: Learn about the different types of Arbitrum nodes and understand the benefits and trade-offs of each type.
+content_type: overview
 ---
 
-In order to be able to _interact with_ or _build applications on_ any of the Arbitrum chains, you need access to the corresponding Arbitrum node. Options are:
+import PublicPreviewBannerPartial from '../partials/_public-preview-banner-partial.mdx';
+import { VanillaAdmonition } from '@site/src/components/VanillaAdmonition/';
 
-- You can use third party node providers (see the list [here](/build-decentralized-apps/reference/01-node-providers.mdx)) to get RPC access to fully-managed nodes
-- You can run your own Arbitrum node, especially if you want to always know the state of the Arbitrum chain
+<VanillaAdmonition type="note">
 
-Here, you can find resources that help you run different types of Arbitrum nodes:
+There is no protocol-level incentive to run an Arbitum full node. If you’re interested in accessing an Arbitrum chain but don’t want to set up a node locally, see our [RPC endpoints and providers](/build-decentralized-apps/reference/01-node-providers.mdx) to get RPC access to fully managed nodes hosted by a third-party provider.
 
-- Step-by-step instructions for running different Arbitrum nodes, including [full Nitro node](/run-arbitrum-node/03-run-full-node.mdx), [full Classic node](/run-arbitrum-node/more-types/03-run-classic-node.mdx), [local full chain simulation](/run-arbitrum-node/04-run-local-full-chain-simulation.mdx), [Nitro dev node](/run-arbitrum-node/run-nitro-dev-node.mdx), [feed relay](/run-arbitrum-node/sequencer/01-run-feed-relay.mdx), and [validator](/run-arbitrum-node/more-types/02-run-validator-node.mdx)
-- Step-by-step instructions for how to [read the sequencer feed](/run-arbitrum-node/sequencer/02-read-sequencer-feed.mdx), [build the Nitro locally](/run-arbitrum-node/nitro/01-build-nitro-locally.mdx) and [run the sequencer coordinator manager UI tool](/run-arbitrum-node/sequencer/03-run-sequencer-coordination-manager.mdx)
-- Step-by-step instructions for [how to configure a Data Availability Committee](/run-arbitrum-node/data-availability-committees/01-get-started.mdx)
-- [Troubleshooting page](/run-arbitrum-node/06-troubleshooting.mdx)
-- [Frequently asked questions](/node-running/faq.mdx)
+</VanillaAdmonition>
+
+:::caution API security disclaimer
+
+When exposing API endpoints to the Internet or any untrusted/hostile network, the following risks may arise:
+
+- **Increased risk of crashes due to Out-of-Memory (OOM)**:
+  Exposing endpoints increases the risk of OOM crashes.
+- **Increased risk of not keeping up with chain progression**:
+  Resource starvation (IO or CPU) may occur, leading to an inability to keep up with chain progression.
+
+We strongly advise against exposing API endpoints publicly. Users considering such exposure should exercise caution and implement the right measures to enhance resilience.
+
+:::
+
+To be able to _interact with_ or _build applications on_ any of the Arbitrum chains, you need access to the corresponding Arbitrum node. Options are:
+
+- You can use [ third party node providers ](/build-decentralized-apps/reference/01-node-providers.mdx) to get RPC access to fully-managed nodes
+- You can run your own Arbitrum node, especially if you want always to know the state of the Arbitrum chain
+
+The rest of this series focuses on the second approach: running your own Arbitrum node.
+
+:::
+
+To be able to _interact with_ or _build applications on_ any of the Arbitrum chains, you need access to the corresponding Arbitrum node. Options are:
+
+When interacting with the Arbitrum network, users have the option to run either a full node or an archive node. There are distinct advantages to running an Arbitrum full node. In this quick start, we will explore the reasons why a user may prefer to run a full node instead of an archive node. By understanding the benefits and trade-offs of each node type, users can make an informed decision based on their specific requirements and objectives.
+
+### Considerations for running an Arbitrum full node
+
+- **Transaction validation and security**: Running a full node allows users to independently validate transactions and verify the state of the Arbitrum blockchain. Users can have complete confidence in the authenticity and integrity of the transactions they interact with.
+- **Reduced trust requirements**: By running a full node, users can interact with the Arbitrum network without relying on third-party services or infrastructure. This independence reduces the need to trust external entities and mitigates the risk of potential centralized failures or vulnerabilities.
+- **Lower resource requirements**: Compared to archive nodes, full nodes generally require fewer resources such as storage and computational power. These requirements make it more accessible to users with limited hardware capabilities or those operating in resource-constrained environments.
+
+For detailed instructions, read [how to run an Arbitrum full node](/run-arbitrum-node/02-run-full-node.mdx).
+
+### Considerations for running an Arbitrum archive node
+
+While full nodes offer numerous advantages, there are situations where running an archive node may be more appropriate. Archive nodes store the complete history of the Arbitrum network, making them suitable for users who require access to extensive historical data or advanced analytical purposes. However, it's important to note that archive nodes are more resource-intensive, requiring significant storage capacity and computational power.
+
+For detailed instructions, read [how to run an Arbitrum archive node](/run-arbitrum-node/more-types/01-run-archive-node.mdx).
+
+### Considerations for running an Arbitrum classic node
+
+The significance of running an Arbitrum classic node is mainly applicable to individuals with specific needs for an archive node and access to classic-related commands.
+
+For detailed instructions, read [how to run an Arbitrum classic node](/run-arbitrum-node/more-types/03-run-classic-node.mdx).
+
+### Considerations for running a feed relay
+
+If you are running a single node, there is no requirement to set up a feed relay. However, if you have multiple nodes, it is highly recommended to have a single feed relay per data center. This setup offers several advantages, including reducing ingress fees and enhancing network stability.
+
+Soon, feed endpoints will mandate compression using a custom dictionary. Therefore, if you plan to connect to a feed using anything other than a standard node, it is strongly advised to run a local feed relay. This local feed relay will ensure that you have access to an uncompressed feed by default, maintaining optimal performance and compatibility.
+
+For detailed instructions, read [how to run an Arbitrum feed relay](/run-arbitrum-node/sequencer/01-run-feed-relay.mdx).