Skip to content

Commit

Permalink
fix: tutorial pages spelling and grammar (#3958)
Browse files Browse the repository at this point in the history
* fix spelling and grammar

* fix links

* Apply suggestions from code review

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/hackathon-prep-course/9-sample-starter-projects.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/hackathon-prep-course/8-managing-canisters.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/hackathon-prep-course/8-managing-canisters.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/developer-journey/level-2/2.4-intro-candid.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/developer-journey/level-2/2.5-unit-testing.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

* Update docs/tutorials/developer-journey/level-3/3.2-https-outcalls.mdx

Co-authored-by: Jennifer K. Tran <[email protected]>

---------

Co-authored-by: Jennifer K. Tran <[email protected]>
  • Loading branch information
jessiemongeon1 and jennifertrin authored Jan 17, 2025
1 parent 0dfa5b0 commit 4bcec19
Show file tree
Hide file tree
Showing 46 changed files with 4,213 additions and 3,555 deletions.
24 changes: 12 additions & 12 deletions docs/tutorials/developer-journey/level-0/01-ic-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ In order to understand how to develop dapps on ICP, first let's take a look at t

## The Internet Computer Protocol

At the core of the Internet Computer is the Internet Computer Protocol (ICP). The ICP is a 4-layer technology stack that runs on the nodes of each subnet. Through the implementation of this 4-layer stack, each subnet is capable of creating a blockchain-based **replicated state machine** which is able to operate independently of other subnets while communicating asynchronously with them. Each subnet processes **messages**, which are received from end-users or other subnets.
At the core of the Internet Computer is the Internet Computer Protocol (ICP). The ICP is a 4-layer technology stack that runs on the nodes of each subnet. Through the implementation of this 4-layer stack, each subnet is capable of creating a blockchain-based **replicated state machine** that can operate independently of other subnets while communicating asynchronously with them. Each subnet processes **messages**, which are received from end-users or other subnets.

### Protocol stack

Expand All @@ -38,19 +38,19 @@ The ICP is comprised of four layers:
3. Message routing.
4. Execution.

Together, the peer-to-peer and consensus layers select and order incoming messages, then provide them to the upper two layers in the form of **blocks**. When the message routing and execution layers receive those blocks that contain ordered messages, they can execute them in a completely deterministic manner across every node on the subnet. This demonstrates a **round** of message execution, and showcases the implementation of the replicated state machine, where every node within the subnet transitions from the same starting state to the same ending state in each round of message execution.
Together, the peer-to-peer and consensus layers select and order incoming messages, then provide them to the upper two layers in the form of **blocks**. When the message routing and execution layers receive those blocks that contain ordered messages, they can execute them in a completely deterministic manner across every node on the subnet. This demonstrates a **round** of message execution and showcases the implementation of the replicated state machine, where every node within the subnet transitions from the same starting state to the same ending state in each round of message execution.

#### Peer-to-peer

In the ICP technology stack, the first layer is the peer-to-peer layer. This layer is responsible for the communication between the nodes within a subnet, and facilitates a reliable and secure channel to do so. Through peer-to-peer communication, nodes on a subnet can broadcast messages, referred to as **artifacts**, to all nodes in the subnet.
In the ICP technology stack, the first layer is the peer-to-peer layer. This layer is responsible for the communication between the nodes within a subnet and facilitates a reliable and secure channel to do so. Through peer-to-peer communication, nodes on a subnet can broadcast messages, referred to as **artifacts**, to all nodes in the subnet.

[Want to go further into this topic?](https://internetcomputer.org/how-it-works/peer-to-peer-p2p/)

#### Consensus

The consensus layer is responsible for assuring that all nodes in a subnet agree on the messages that are processed on the subnet and the order that they are processed in. This is important to ensure that all nodes make the same state transition when executing messages. Each subnet on ICP runs consensus independently of the other subnets.

A unique aspect of ICP consensus protocol is that it provides **cryptographically guaranteed finality**, which is different in comparison to other consensus protocols, such as the one used by Bitcoin, which provides **probabilistic finality**.
A unique aspect of the ICP consensus protocol is that it provides **cryptographically guaranteed finality**, which is different in comparison to other consensus protocols, such as the one used by Bitcoin, which provides **probabilistic finality**.

[Want to go further into this topic?](https://internetcomputer.org/how-it-works/consensus/)

Expand All @@ -76,7 +76,7 @@ At the core of chain-key cryptography is a **threshold signature scheme**. A thr

Through chain-key cryptography:
- Anyone can verify content received by ICP by validating a signature without needing to sync the entire blockchain network.
- New subnets and nodes can be added, or faulty nodes can be recovered, autonomously.
- New subnets and nodes can be added, or faulty nodes can be recovered autonomously.
- Chain-key cryptography provides a source of pseudo-randomness that can be used by canisters for algorithms that require randomness.

[**Chain-key signatures**](https://internetcomputer.org/how-it-works/chain-key-technology/) provide the ability for transactions that are targeted at other blockchain networks to be computed fully onchain using ICP. This allows for integrations with other blockchains such as Bitcoin and Ethereum.
Expand All @@ -98,7 +98,7 @@ Controllers are also responsible for assuring that a canister contains sufficien

## Tokens

The Internet Computer's utility token is **ICP**, named after the Internet Computer Protocol. This utility token is used for several functions within the network, such as being staked to have voting power in the NNS, or being used to purchase **cycles**, which are used to power canisters deployed on the mainnet network.
The Internet Computer's utility token is **ICP**, named after the Internet Computer Protocol. This utility token is used for several functions within the network, such as being staked to have voting power in the NNS or being used to purchase **cycles**, which are used to power canisters deployed on the mainnet network.

[Want to go further into this topic?](https://internetcomputer.org/how-it-works/tokenomics/)

Expand All @@ -112,31 +112,31 @@ The Internet Computer is governed by the **Network Nervous System (NNS)**, which

### Service Nervous System

Dapps deployed on ICP can be governed in the same manner that ICP itself is governed - through a DAO, referred to as an **SNS, or Service Nervous System**. An SNS is a version of the NNS that is responsible for tokenizing and decentralizing a single dapp. Once a dapp's control has been handed over to an SNS, it can be managed through proposals that are voted on by those that have staked the dapp's native token.
Dapps deployed on ICP can be governed in the same manner that ICP itself is governedthrough a DAO, referred to as an **SNS, or Service Nervous System**. An SNS is a version of the NNS that is responsible for tokenizing and decentralizing a single dapp. Once a dapp's control has been handed over to an SNS, it can be managed through proposals that are voted on by those who have staked the dapp's native token.

[Want to go further into this topic?](https://internetcomputer.org/sns/)

## Internet Identity

The Internet Computer has pioneered a secure and advanced form of cryptographic authentication, known as **Internet Identity (II)**. II Is designed to work across all user devices and protect user privacy as a means to replace traditional usernames and passwords, which can be hard to manage and easy to exploit.
The Internet Computer has pioneered a secure and advanced form of cryptographic authentication, known as **Internet Identity (II)**. II is designed to work across all user devices and protect user privacy as a means to replace traditional usernames and passwords, which can be hard to manage and easy to exploit.

II can be integrated with dapps on ICP and helps secure your online identity by providing protection from websites collecting your data. II does this through the ability for users to create new anonymous, independent accounts for each website that they visit.

[Want to go further into this topic?](https://internetcomputer.org/how-it-works/web-authentication-identity/)

## Need help?

Did you get stuck somewhere in this tutorial, or feel like you need additional help understanding some of the concepts? The ICP community has several resources available for developers, like working groups and bootcamps, along with our Discord community, forum, and events such as hackathons. Here are a few to check out:
Did you get stuck somewhere in this tutorial, or do you feel like you need additional help understanding some of the concepts? The ICP community has several resources available for developers, like working groups and bootcamps, along with our Discord community, forum, and events such as hackathons. Here are a few to check out:

- [Developer Discord](https://discord.internetcomputer.org), which is a large chatroom for ICP developers to ask questions, get help, or chat with other developers asynchronously via text chat.

- [Developer ladder forum discussion](https://forum.dfinity.org/t/developer-journey-feedback-and-discussion/23893).

- [Developer tooling working group](https://www.google.com/calendar/event?eid=MHY0cjBubmlnYXY1cTkzZzVzcmozb3ZjZm5fMjAyMzEwMDVUMTcwMDAwWiBjX2Nnb2VxOTE3cnBlYXA3dnNlM2lzMWhsMzEwQGc&ctz=Europe/Zurich).

- [Motoko Bootcamp - The DAO Adventure](https://github.com/motoko-bootcamp/dao-adventure) - Discover the Motoko language in this 7 day adventure and learn to build a DAO on the Internet Computer.
- [Motoko Bootcamp - The DAO Adventure](https://github.com/motoko-bootcamp/dao-adventure) - Discover the Motoko language in this 7-day adventure and learn to build a DAO on the Internet Computer.

- [Motoko Bootcamp - Discord community](https://discord.gg/YbksCUxdzk) - A community for and by Motoko developers to ask for advice, showcase projects and participate in collaborative events.
- [Motoko Bootcamp - Discord community](https://discord.gg/YbksCUxdzk) - A community for and by Motoko developers to ask for advice, showcase projects, and participate in collaborative events.

- [Motoko developer working group](https://www.google.com/calendar/event?eid=ZWVnb2luaHU0ZjduMTNpZHI3MWJkcWVwNWdfMjAyMzEwMTJUMTUwMDAwWiBjX2Nnb2VxOTE3cnBlYXA3dnNlM2lzMWhsMzEwQGc&ctz=Europe/Zurich).

Expand All @@ -151,4 +151,4 @@ Did you get stuck somewhere in this tutorial, or feel like you need additional h

## Next steps

- [0.2 Internet Computer terminology](/docs/current/tutorials/developer-journey/level-0/ic-terms).
- [0.2 Internet Computer terminology](/docs/current/tutorials/developer-journey/level-0/ic-terms).
Loading

0 comments on commit 4bcec19

Please sign in to comment.