Merge pull request #3718 from dfinity/jessiemongeon1-patch-1

update: network overview first paragraph

blog/news-and-updates/2024-10-09-update.mdx

@@ -29,7 +29,7 @@ Over the past few weeks, several new documentation pages have been added to the
 
 - [Cycles pricing calculator](/docs/current/developer-docs/cost-estimations-and-examples)
 
-Check out all of the [ICP developer documentation](/docs/current/developer-docs/getting-started/overview-of-icp).
+Check out all of the [ICP developer documentation](/docs/current/developer-docs/getting-started/network-overview).
 
 ## ICP developer office hours
 

docs/developer-docs/getting-started/overview-of-icp.mdx → docs/developer-docs/getting-started/network-overview.mdx

@@ -6,11 +6,11 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
 import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
 import { GlossaryTooltip } from "/src/components/Tooltip/GlossaryTooltip";
 
-# Overview of ICP
+# Network overview
 
 <MarkdownChipRow labels={["Beginner", "Getting started" ]} />
 
-The Internet Computer Protocol (ICP) is a blockchain based on [threshold cryptography](https://en.wikipedia.org/wiki/Threshold_cryptosystem), [state machine replication](https://en.wikipedia.org/wiki/State_machine_replication), and [a novel consensus algorithm](https://eprint.iacr.org/2021/632.pdf).
+**The Internet Computer (ICP) is the first "World Computer" network. It enables you to build web applications and internet services using a 100% decentralized platform without Big Tech and traditional IT. While traditional blockchains struggle to store a single phone photo onchain, ICP already hosts social networks, multiple ledgers, AI and much more, fully onchain.**
 
 It was carefully designed to give smart contracts near native performance and scalability while maintaining the security of decentralized execution.
 In addition to classical DeFi smart contracts, such as ledgers and exchanges, ICP can run compute- and storage-heavy applications such as [image classification](https://github.com/dfinity/examples/tree/master/rust/image-classification) fully onchain.
@@ -316,4 +316,4 @@ Currently, subnets contain between 13 and 40 nodes, and most of them are geograp
 </tr>
 
 </tbody>
-</table>
+</table>

docs/developer-docs/multi-chain/ethereum/using-eth/eth-comparison.mdx

@@ -10,7 +10,7 @@ import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
 ## Overview
 This guide is designed to help Ethereum developers understand the core concepts of ICP, focusing on the terminology and functionalities that differ between the two protocols. While the underlying concepts might be similar, ICP utilizes different terms to describe them.
 
-For a feature comparison between the two protocols, refer to the [quick comparison between ICP and Ethereum](/docs/current/developer-docs/getting-started/overview-of-icp#quick-comparison-with-ethereum).
+For a feature comparison between the two protocols, refer to the [quick comparison between ICP and Ethereum](/docs/current/developer-docs/getting-started/network-overview#quick-comparison-with-ethereum).
 
 ## Terminology mapping
 This table summarizes the key terminology differences between Ethereum and ICP:

docs/developer-docs/multi-chain/overview.mdx

@@ -115,7 +115,7 @@ A canister’s interaction with external blockchains requires submitting transac
 
 A key question we must answer to fully understand the security of ICP's Chain Fusion capabilities is: whom do users place trust in when using the presented infrastructure?
 
-ICP’s decentralization is rooted in the replicated execution and state of canister smart contracts which depends on the honesty of a supermajority of subnet [nodes](/docs/current/developer-docs/getting-started/overview-of-icp#nodes). These nodes are sourced from various identifiable and DAO-approved providers that operate in globally distributed data centers.
+ICP’s decentralization is rooted in the replicated execution and state of canister smart contracts which depends on the honesty of a supermajority of subnet [nodes](/docs/current/developer-docs/getting-started/network-overview#nodes). These nodes are sourced from various identifiable and DAO-approved providers that operate in globally distributed data centers.
 
 In case of direct chain integration, the only trust assumption needed is that a supermajority of subnet nodes are honest and in consensus. In case of integration via RPC, users additionally need to trust RPC node providers. While this is seen as less secure than a direct integration that involves running a full node, it's currently deemed an acceptable trade-off (due to a reliance on replicated results from multiple independent providers).
 

docs/developer-docs/smart-contracts/overview/introduction.mdx

@@ -29,7 +29,7 @@ While these associations are partial, they are correct. Together they form a com
 ## Canisters as smart contracts
 
 Canisters are much like a smart contract in that their execution is governed by a secure protocol; in this case, the ICP protocol. Canisters running on ICP are tamper-proof, since their state can only be modified through messages that are executed onchain. A canister’s state can be audited and cryptographically verified using ICP’s chain-key cryptography.
-For a brief comparison between canisters and Ethereum smart contracts, refer to the table [Quick comparison with Ethereum](/docs/developer-docs/getting-started/overview-of-icp.mdx#quick-comparison-with-ethereum).
+For a brief comparison between canisters and Ethereum smart contracts, refer to the table [Quick comparison with Ethereum](/docs/developer-docs/getting-started/network-overview.mdx#quick-comparison-with-ethereum).
 
 ## Canisters as actors
 

plugins/utils/redirects.js

@@ -27,7 +27,7 @@ const redirects = `
   /docs /docs/current/home
   /docs/current/ /docs/current/home
   /docs/current/concepts/bitcoin-integration /bitcoin-integration
-  /docs/current/developer-docs/ic-overview /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/developer-docs/ic-overview /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/production/computation-and-storage-costs /docs/current/developer-docs/gas-cost
   /docs/current/developer-docs/deploy/computation-and-storage-costs /docs/current/developer-docs/gas-cost
   /docs/current/ic-overview  /docs/current/home
@@ -97,7 +97,7 @@ const redirects = `
   /docs/developers-guide/about-this-guide /docs/current/motoko/main/getting-started/motoko-introduction
   /docs/developers-guide/basic-syntax-rules /docs/current/motoko/main/reference/language-manual
   /docs/developers-guide/concepts/bitcoin-integration /bitcoin-integration
-  /docs/developers-guide/concepts/concepts-intro /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/developers-guide/concepts/concepts-intro /docs/current/developer-docs/getting-started/network-overview
   /docs/developers-guide/customize-projects /docs/current/developer-docs/smart-contracts/compile
   /docs/developers-guide/default-wallet /docs/current/developer-docs/defi/cycles/cycles-wallet
   /docs/developers-guide/design-apps /docs/current/developer-docs/web-apps/design-dapps
@@ -145,7 +145,7 @@ const redirects = `
   /docs/current/tokenomics/nns/community-fund /docs/current/developer-docs/daos/nns/concepts/neurons-fund
   /docs/current/tokenomics/sns/* /docs/current/developer-docs/daos/sns/tokenomics/:splat
   /docs/developers-guide/cli-reference/* /docs/current/developer-docs/developer-tools/cli-tools/cli-reference/:splat
-  /docs/developers-guide/concepts/* /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/developers-guide/concepts/* /docs/current/developer-docs/getting-started/network-overview
   /docs/developers-guide/tutorials/* /docs/current/motoko/main/getting-started/motoko-introduction
   /docs/ic-identity-guide/* /docs/current/tokenomics/identity-auth/:splat
   /docs/language-guide/* /docs/current/motoko/main/:splat
@@ -177,11 +177,11 @@ const redirects = `
   /docs/developers-guide/tutorials-intro.html /docs/current/tutorials/developer-journey/
   /docs/quickstart/quickstart.html /docs/current/developer-docs/getting-started/install/
   /apis/site/proxy /docs/current/references/http-gateway-protocol-spec
-  /docs/developers-guide/concepts/what-is-ic /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/developers-guide/concepts/what-is-ic /docs/current/developer-docs/getting-started/network-overview
   /language-guide/index /docs/current/tutorials/developer-journey/level-0/intro-languages
   /docs/current/developer-docs/production/instruction-limits /docs/current/developer-docs/smart-contracts/maintain/resource-limits
   /docs/current/developer-docs/backend/resource-limits /docs/current/developer-docs/smart-contracts/maintain/resource-limits
-  /docs/current/concepts/data-centers /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/concepts/data-centers /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/build/languages/rust/rust-intro /docs/current/developer-docs/backend/rust/
   /docs/current/developer-docs/build/languages/motoko /docs/current/motoko/main/getting-started/motoko-introduction
   /docs/current/developer-docs/integrations/sns/launching/launch-summary /docs/current/developer-docs/daos/sns/launching/launch-summary-1proposal
@@ -192,27 +192,27 @@ const redirects = `
   /docs/current/developer-docs/frontend/vue-frontend /docs/current/developer-docs/web-apps/application-frontends/overview
   /docs/current/developer-docs/setup/cycles/index /docs/current/developer-docs/defi/cycles/cycles-wallet
   /docs/current/developer-docs/setup/cycles /docs/current/developer-docs/defi/cycles/cycles-wallet
-  /docs/current/concepts/index /docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/concepts /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/concepts/index /docs/current/developer-docs/getting-started/network-overview
+  /docs/current/concepts /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/backend/candid/index /docs/current/developer-docs/smart-contracts/candid/candid-concepts
   /docs/current/developer-docs/integrations/https-outcalls/index /docs/current/developer-docs/smart-contracts/advanced-features/https-outcalls/https-outcalls-how-to-use
   /docs/current/developer-docs/integrations/https-outcalls /docs/current/developer-docs/smart-contracts/advanced-features/https-outcalls/https-outcalls-how-to-use
   /docs/current/developer-docs/security/index /docs/current/developer-docs/security/security-best-practices/inter-canister-calls
   /docs/current/developer-docs/security /docs/current/developer-docs/security/security-best-practices/inter-canister-calls
-  /docs/current/developer-docs/integrations/index /docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/developer-docs/integrations /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/developer-docs/integrations/index /docs/current/developer-docs/getting-started/network-overview
+  /docs/current/developer-docs/integrations /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/setup/index /docs/current/developer-docs/getting-started/install/
   /docs/current/developer-docs/setup /docs/current/developer-docs/getting-started/install/
   /docs/current/developer-docs/setup/quickstart /docs/current/developer-docs/getting-started/install/
-  /docs/current/tutorials/index /docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/tutorials/ /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/tutorials/index /docs/current/developer-docs/getting-started/network-overview
+  /docs/current/tutorials/ /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/backend/eu-subnets /docs/current/references/subnets/subnet-types
   /docs/current/samples/* /docs/current/samples/overview
   /docs/current/developer-docs/backend/choosing-language /docs/current/developer-docs/smart-contracts/write/overview
   /docs/current/developer-docs/production/deploying-and-upgrading /docs/current/developer-docs/smart-contracts/deploy/overview
-  /docs/current/developer-docs/index /docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/developer-docs /docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/concepts/what-is-ic /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/developer-docs/index /docs/current/developer-docs/getting-started/network-overview
+  /docs/current/developer-docs /docs/current/developer-docs/getting-started/network-overview
+  /docs/current/concepts/what-is-ic /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/setup/development-workflow /docs/current/developer-docs/getting-started/development-workflow
   /docs/current/developer-docs/setup/hello-world /docs/current/developer-docs/getting-started/hello-world
   /docs/current/developer-docs/setup/install/ /docs/current/developer-docs/getting-started/install/
@@ -544,7 +544,7 @@ const redirects = `
   /docs/integration/ledger-quick-start.html /docs/current/developer-docs/defi/tokens/ledger/setup/icp_ledger_setup
   /docs/current/developer-docs/integrations/storage/cost /docs/current/developer-docs/gas-cost
   /docs/token-holders/self-custody-quickstart.html /docs/current/developer-docs/defi/wallets/self-custody/self-custody-quickstart
-  /docs/current/developer-docs/overview/ /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/developer-docs/overview/ /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/smart-contracts/overview	/docs/current/developer-docs/smart-contracts/overview/introduction
   /docs/current/references/dfx-json-reference /docs/current/developer-docs/developer-tools/cli-tools/dfx-json-reference
   /docs/language-guide/language-manual.html	/docs/current/motoko/main/getting-started/motoko-introduction
@@ -581,8 +581,8 @@ const redirects = `
   /docs/candid-guide/candid-concepts.html	/docs/current/developer-docs/smart-contracts/candid/
   /docs/current/blog/features/vetkey-primer	/blog/features/vetkey-primer
   /docs/current/concepts/chain-key-technology/ /docs/current/developer-docs/multi-chain/overview
-  /docs/current/concepts/concepts-intro.html	/docs/current/developer-docs/getting-started/overview-of-icp
-  /docs/current/developer-docs/backend	/docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/concepts/concepts-intro.html	/docs/current/developer-docs/getting-started/network-overview
+  /docs/current/developer-docs/backend	/docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/backend/rust/rust-quickstart	/docs/current/developer-docs/backend/rust/
   /docs/current/developer-docs/best-practices/	/docs/current/developer-docs/smart-contracts/best-practices/general
   /docs/current/developer-docs/best-practices/considerations-for-nft-devs /docs/current/developer-docs/defi/nfts/overview
@@ -601,7 +601,7 @@ const redirects = `
   /docs/current/developer-docs/web-apps/application-frontends/custom-frontend /docs/current/developer-docs/web-apps/application-frontends/default-frontend
   /docs/current/developer-docs/security/rust-canister-development-security-best-practices /docs/current/developer-docs/security/security-best-practices/inter-canister-calls
   /docs/developers-guide/computation-and-storage-costs.html /docs/current/developer-docs/gas-cost
-  /docs/current/developer-docs/getting-started/ /docs/current/developer-docs/getting-started/overview-of-icp
+  /docs/current/developer-docs/getting-started/ /docs/current/developer-docs/getting-started/network-overview
   /docs/current/developer-docs/defi/wallets/workflow /docs/current/developer-docs/defi/wallets/overview
   /docs/current/developer-docs/backend/rust/infrastructure /docs/current/developer-docs/backend/rust/
   /docs/current/developer-docs/smart-contracts/deploy/larger-wasm /docs/current/developer-docs/smart-contracts/install

sidebars.js

@@ -9,8 +9,8 @@ const sidebars = {
       items: [
         {
           type: "doc",
-          label: "Overview of ICP",
-          id: "developer-docs/getting-started/overview-of-icp",
+          label: "Network overview",
+          id: "developer-docs/getting-started/network-overview",
         },
         {
           type: "doc",

src/components/DocsHome/index.tsx

@@ -473,7 +473,7 @@ const DocsHomePage: FC = () => {
             <p className="mb-0">
               <Link
                 className="button-white button-with-icon"
-                href="/docs/current/developer-docs/getting-started/overview-of-icp"
+                href="/docs/current/developer-docs/getting-started/network-overview"
               >
               Learn more
               <LinkArrowRight />