refactor: reorganize endpoints

feat: add missing deprecation warning
fix: import Deployment snippet correctly
refactor: dryify snippets
refactor: export default function in snippet
refactor: reorder Lockup Dynamic and Lockup Tranched
refactor: various improvements and rewordings

Author: PaulRBerg

docs/api/05-development.mdx

@@ -11,11 +11,7 @@ import LinkPreview from "@site/src/components/LinkPreview";
 ### Integrate
 
 To integrate the Sablier subgraphs or indexers into your project, start from the official `@sablier/subgraphs`
-repository. We recommend using:
-
-- [GraphQL Code Generator](https://the-guild.dev/graphql/codegen/docs/getting-started) to create types from your GraphQL
-  fragments and queries.
-- [TanStack Query](https://tanstack.com/query) to fetch results from the exposed endpoints.
+repository.
 
 <LinkPreview
   href="https://github.com/sablier-labs/subgraphs"
@@ -24,6 +20,12 @@ repository. We recommend using:
   title="Github - sablier-labs/subgraphs: Sablier Subgraphs"
 />
 
+We recommend using:
+
+- [GraphQL Code Generator](https://the-guild.dev/graphql/codegen/docs/getting-started) to create types from your GraphQL
+  fragments and queries.
+- [TanStack Query](https://tanstack.com/query) to fetch results from the exposed endpoints.
+
 ### Contribute
 
 To contribute to the subgraphs or deploy your own, head over to the GitHub

docs/api/airdrops/01-overview.mdx

@@ -8,9 +8,9 @@ import LinkPreview from "@site/src/components/LinkPreview";
 
 # Airdrops
 
-Sablier's [Lockup](/concepts/lockup/overview) streams are used for the [Vesting](/apps/features/vesting) and (part of)
-the [Airdrops](/apps/features/airdrops) components of the Sablier Interfaces. The Airdrops component is supported by our
-[Merkle](/concepts/merkle-airdrops) utilities and focuses on the functionality of the Merkle Factory peripheries.
+Sablier's [Lockup](/concepts/lockup/overview) streams are used for the [Vesting](/apps/features/vesting) feature and
+some of the [Airdrops](/apps/features/airdrops) features of the Sablier Interface. The Airdrops component is supported
+by our [Merkle](/concepts/merkle-airdrops) utilities and focuses on the functionality of the Merkle Factory.
 
 Airdrops-native functionality is powered by:
 

docs/api/airdrops/02-endpoints.mdx

@@ -4,23 +4,33 @@ sidebar_position: 2
 title: "Endpoints"
 ---
 
-import DeprecatedWarning from "@site/docs/snippets/DeprecatedWarning.mdx";
+import DeprecatedSubgraphs from "@site/docs/snippets/DeprecatedSubgraphs.mdx";
+import EnvioTip from "@site/docs/snippets/EnvioTip.mdx";
 import TheGraphSunset from "@site/docs/snippets/TheGraphSunset.mdx";
 import LinkPreview from "@site/src/components/LinkPreview";
 
-# Airdrops
+# Airdrops Endpoints
 
 ## The Graph
 
-This subgraph tracks events emitted by the `@sablier/airdrops` contracts, specifically the ones in charge of merkle
-distributions. It deals with airdrops-specific actions like the factory creating an airstream campaign, admin clawbacks,
-or users claiming stream NFTs as defined in the attached Merkle tree.
+This subgraph tracks events emitted by the Sablier Airdrops contracts, specifically the ones in charge of Merkle
+distributions. It deals with airdrop-specific actions like the factory deploying an airdrop campaign, admin clawbacks,
+and users claiming airdrops.
 
-Airdrops work in tandem with [vesting](/apps/features/vesting) as Merkle distributions will produce new
-[lockup](/api/lockup/overview) streams. Be sure to check out that part of the docs too.
+Airdrops work in tandem with our [Vesting](/apps/features/vesting) feature since some Merkle distributions will produce
+new [Lockup](/api/lockup/overview) streams.
 
 <TheGraphSunset />
-<DeprecatedWarning />
+<DeprecatedSubgraphs protocol="airdrops" />
+
+### Source Code
+
+<LinkPreview
+  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/merkle"
+  icon="github"
+  subtitle="@sablier-labs/subgraphs - apps/merkle"
+  title="Sablier Subgraphs - Merkle - The Graph"
+/>
 
 ### Endpoints
 
@@ -47,27 +57,22 @@ Airdrops work in tandem with [vesting](/apps/features/vesting) as Merkle distrib
 | Sepolia          | [sablier-airdrops-sepolia][explorer-airdrops-sepolia]                   | [Studio][studio-airdrops-sepolia]          | [De. Network][network-airdrops-sepolia]          |
 | zkSync           | [sablier-airdrops-zksync][explorer-airdrops-zksync]                     | [Studio][studio-airdrops-zksync]           | [De. Network][network-airdrops-zksync]           |
 
-### Code
-
-<LinkPreview
-  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/merkle"
-  icon="github"
-  subtitle="@sablier-labs/subgraphs - apps/merkle"
-  title="Sablier Subgraphs - Merkle - The Graph"
-/>
-
 ## Envio
 
+<EnvioTip />
+
 This indexers tracks the events emitted by the `@sablier/airdrops` contracts, specifically the ones in charge of merkle
 distributions. It deals with airdrops-specific actions like the factory creating an airstream campaign, admin clawbacks,
 or users claiming stream NFTs as defined in the attached Merkle tree.
 
-:::tip Chains: Individual vs. Aggregated
-
-While subgraphs are chain-tethered (one subgraph endpoint per chain), Envio indexes all chains within the same
-deployment. The data from all of chains that Sablier is deployed on can be queried from a single endpoint.
+### Source Code
 
-:::
+<LinkPreview
+  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/merkle-envio"
+  icon="github"
+  subtitle="@sablier-labs/subgraphs - apps/merkle-envio"
+  title="Sablier Subgraphs - Merkle - Envio"
+/>
 
 ### Endpoints
 
@@ -78,28 +83,13 @@ deployment. The data from all of chains that Sablier is deployed on can be queri
 The endpoint is meant to be plugged into a query client. Use
 [Hasura's online explorer](https://cloud.hasura.io/public/graphiql?) to view the entities and query API.
 
-### Code
-
-<LinkPreview
-  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/merkle-envio"
-  icon="github"
-  subtitle="@sablier-labs/subgraphs - apps/merkle-envio"
-  title="Sablier Subgraphs - Merkle - Envio"
-/>
-
 ## Sablier SDK: Merkle API
 
 Sablier's Airdrops rely on pre-configured Merkle trees. This data structure contains the list of recipients as well as
 their individual claim details. We use the following service to create the Merkle tree, as well as proofs for the
 recipient's claims.
 
-### Endpoints
-
-| Host    | Endpoint                              |
-| ------- | ------------------------------------- |
-| Sablier | https://sablier-merkle-api.vercel.app |
-
-### Code
+### Source Code
 
 <LinkPreview
   href="https://github.com/sablier-labs/merkle-api"
@@ -108,6 +98,12 @@ recipient's claims.
   title="Sablier SDK - Merkle API"
 />
 
+### Endpoints
+
+| Host    | Endpoint                              |
+| ------- | ------------------------------------- |
+| Sablier | https://sablier-merkle-api.vercel.app |
+
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}

docs/api/airdrops/deprecated/01-old-endpoints.mdx renamed to docs/api/airdrops/06-previous-endpoints.mdx

@@ -1,17 +1,13 @@
 ---
-id: "old_endpoints"
-sidebar_position: 1
-title: "Endpoints"
+id: "previous-endpoints"
+sidebar_position: 6
+title: "Previous Endpoints"
 ---
 
 import DeprecatedEndpoints from "@site/docs/snippets/DeprecatedEndpoints.mdx";
 
-# Airdrops
-
 <DeprecatedEndpoints />
 
-### Deprecated Endpoints
-
 | Chain            | Explorer                                                          | Studio[^2]                              | Decentralized Network[^1]                     |
 | ---------------- | ----------------------------------------------------------------- | --------------------------------------- | --------------------------------------------- |
 | Ethereum         | [sablier-v2-ms][v2-explorer-ms-ethereum]                          | [Studio][v2-studio-ms-ethereum]         | [De. Network][v2-network-ms-ethereum]         |

docs/api/airdrops/deprecated/_category_.json

@@ -1,5 +1,5 @@
 {
   "collapsed": true,
   "label": "Envio",
-  "position": 4
+  "position": 5
 }

docs/api/airdrops/envio/_category_.json

@@ -1,5 +1,5 @@
 {
   "collapsed": true,
   "label": "Merkle API",
-  "position": 5
+  "position": 3
 }

docs/api/airdrops/merkle-api/_category_.json

@@ -1,5 +1,5 @@
 {
   "collapsed": true,
   "label": "The Graph",
-  "position": 3
+  "position": 4
 }

docs/api/airdrops/the-graph/_category_.json

@@ -8,7 +8,7 @@ import LinkPreview from "@site/src/components/LinkPreview";
 
 # Sablier Flow
 
-Sablier's [Flow](/concepts/flow/overview) streams enable the [payments](/apps/features/payments) functionality of the
+Sablier's [Flow](/concepts/flow/overview) streams enable the [Payments](/apps/features/payments) functionality of the
 Sablier Interface.
 
 The Flow data is powered by:

docs/api/flow/01-overview.mdx

@@ -4,17 +4,29 @@ sidebar_position: 2
 title: "Endpoints"
 ---
 
+import DeprecatedSubgraphs from "@site/docs/snippets/DeprecatedSubgraphs.mdx";
+import EnvioTip from "@site/docs/snippets/EnvioTip.mdx";
 import TheGraphSunset from "@site/docs/snippets/TheGraphSunset.mdx";
 import LinkPreview from "@site/src/components/LinkPreview";
 
-# Flow
+# Flow Endpoints
 
 ## The Graph
 
-This subgraph tracks events emitted by the `@sablier/flow` contracts, and deals with protocol actions like creating,
+This subgraph tracks events emitted by the Sablier Flow contracts, and deals with protocol actions like creating,
 depositing or voiding flow streams.
 
 <TheGraphSunset />
+<DeprecatedSubgraphs protocol="flow" />
+
+### Source Code
+
+<LinkPreview
+  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/flow"
+  icon="github"
+  subtitle="@sablier-labs/subgraphs - apps/flow"
+  title="Sablier Subgraphs - Flow - The Graph"
+/>
 
 ### Endpoints
 
@@ -40,27 +52,22 @@ depositing or voiding flow streams.
 | Sepolia          | [sablier-flow-sepolia][explorer-flow-sepolia]                   | [Studio][studio-flow-sepolia]          | [De. Network][network-flow-sepolia]          |
 | zkSync           | [sablier-flow-zksync][explorer-flow-zksync]                     | [Studio][studio-flow-zksync]           | [De. Network][network-flow-zksync]           |
 
-### Code
-
-<LinkPreview
-  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/flow"
-  icon="github"
-  subtitle="@sablier-labs/subgraphs - apps/flow"
-  title="Sablier Subgraphs - Flow - The Graph"
-/>
-
 ## Envio
 
-:::tip Chains: Individual vs. Aggregated
-
-While subgraphs are chain-tethered (one subgraph endpoint per chain), Envio indexes all chains within the same
-deployment. The data from all of chains that Sablier is deployed on can be queried from the same place.
-
-:::
+<EnvioTip />
 
 The `flow-envio` indexer tracks events emitted by the `@sablier/flow` contracts. It deals with core protocol actions
 like creating, depositing, or voiding flow streams.
 
+### Source Code
+
+<LinkPreview
+  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/flow-envio"
+  icon="github"
+  subtitle="@sablier-labs/subgraphs - apps/flow-envio"
+  title="Sablier Subgraphs - Flow - Envio"
+/>
+
 ### Endpoints
 
 | Chain            | Endpoint (Hosted Network)                                        |
@@ -70,15 +77,6 @@ like creating, depositing, or voiding flow streams.
 The endpoint is meant to be plugged into a query client. Use
 [Hasura's online explorer](https://cloud.hasura.io/public/graphiql?) to view the entities and query API.
 
-### Code
-
-<LinkPreview
-  href="https://github.com/sablier-labs/subgraphs/blob/main/apps/flow-envio"
-  icon="github"
-  subtitle="@sablier-labs/subgraphs - apps/flow-envio"
-  title="Sablier Subgraphs - Flow - Envio"
-/>
-
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}
 {/* --------------------------------------------------------------------------------------------------------------------------------- */}