Skip to content

Commit 1770a13

Browse files
committed
Adjust language to focus more on being a Bitcoin L2
1 parent 0a4a567 commit 1770a13

File tree

2 files changed

+17
-30
lines changed

2 files changed

+17
-30
lines changed

docs/intro.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -5,19 +5,19 @@ sidebar_position: 1
55

66
# Stacks Docs
77

8-
**Stacks brings smart contract functionality to Bitcoin, without modifying Bitcoin itself.**
8+
**Stacks is Bitcoin L2 that brings smart contract functionality to Bitcoin, without modifying Bitcoin itself.**
99

1010
These docs serve as:
1111

12-
1. An introduction to Stacks (what it is, why you should care, how to build on it),
12+
1. An introduction to Stacks (what it is, why you should care, how to build Bitcoin apps with it),
1313
2. A reference guide to various aspects of the Stacks ecosystem
1414
3. A collection of tutorials and code samples to help you learn and build
1515

1616
If you see something you think you might want to contribute, [please do so](/docs/contribute)! We are always looking for good contributions from the community.
1717

1818
## Tutorials
1919

20-
Looking to understand how to build full-stack dapps on Stacks? These tutorials will give you a solid introduction. At the moment we have an intro tutorial and a collection of community-created tutorials, with a comprehensive deep-dive tutorial covering BTC integration on the way.
20+
Looking to understand how to build full-stack Bitcoin dapps with Stacks? These tutorials will give you a solid introduction. At the moment we have an intro tutorial and a collection of community-created tutorials focusing on Stacks and Clarity specifically, with a comprehensive deep-dive tutorial series covering Bitcoin-first development on the way.
2121

2222
[View Hello Stacks Tutorial](/docs/tutorials/hello-stacks)
2323

docs/stacks-academy/what-is-stacks.md

+14-27
Original file line numberDiff line numberDiff line change
@@ -10,28 +10,11 @@ We can get an idea of the goal and ethos behind Stacks by looking at [how Satosh
1010

1111
> "...to be a completely separate network and separate block chain, yet share CPU power with Bitcoin...all networks in the world would share combined CPU power, increasing the total strength."
1212
13-
This is major theme in the design decisions for Stacks.
14-
15-
There's a lot of jargon, possible assumptions, controversy, and cool technology wrapped up in those statements. So let's get started by getting a 30,000 foot view of what exactly Stacks is.
16-
17-
## Stacks Explained in (Slightly Less Than) 10 Minutes
18-
19-
<div style={{ position: "relative", paddingBottom: "56.25%", height: 0 }}>
20-
<iframe
21-
src="https://www.loom.com/embed/158047e5036b434aa484ae26a1ba6de1"
22-
frameborder="0"
23-
webkitallowfullscreen
24-
mozallowfullscreen
25-
allowfullscreen
26-
style={{
27-
position: "absolute",
28-
top: 0,
29-
left: 0,
30-
width: "100%",
31-
height: "100%",
32-
}}
33-
></iframe>
34-
</div>
13+
This is major theme in the design decisions for Stacks. A bit of a contradiction in the Bitcoin world, the Stacks network is a Bitcoin L2, but it does have its own token.
14+
15+
This is an intentional and critical design decision primarily for the purpose of maintaining decentralization, rather than needing to rely on a federation.
16+
17+
If that's confusing or you are skeptical, that's understandable, we'll be diving deeper into these ideas as we go through Stacks Academy.
3518

3619
## Stacks and the Purpose of Blockchain Technology
3720

@@ -51,19 +34,23 @@ Bitcoin is the most decentralized, most secure, and most immutable blockchain ne
5134

5235
Bitcoin is very slow compared to other networks. Bitcoin only has a new block written once every 10 minutes or so, making its throughput negligible compared to networks designed for speed like Solana.
5336

54-
Bitcoin is also boring. Ethereum came along after Bitcoin and sought to do the same thing for software that Bitcoin did for money. Ethereum's goal is to be a decentralized supercomputer of sorts, serving as a global compute environment for smart contracts (code that is written to a blockchain).
37+
Bitcoin is also "boring". Ethereum came along after Bitcoin and sought to do the same thing for software that Bitcoin did for money. Ethereum's goal is to be a decentralized supercomputer of sorts, serving as a global compute environment for smart contracts (code that is written to a blockchain).
5538

5639
Bitcoin is also not scalable. Because every new block must propagate to every node on the network, Bitcoin can only run as fast as the slowest node in the network. Now we are seeing the rise of modular blockchain networks like Cosmos that are designed to make it easy for people to spin up their own blockchain networks.
5740

58-
While most new blockchain protocols popping up these days see these properties as negatives and seek to eliminate them, Stacks takes a different approach.
41+
While most new blockchain protocols popping up these days see these properties as negatives and seek to eliminate them, the Stacks community sees things differently.
5942

6043
## The Stacks Way
6144

6245
Stacks takes a pyramid approach, where you have the foundational settlement layer at the bottom (Bitcoin), and then a layer on top of that to add smart contracts and programmability (Stacks), and then layers on top of that for scalability and speed (Hiro's Subnets).
6346

64-
By taking this approach, we are able to have all of the same functionality as chains like Ethereum without all of the drawbacks of having a massively complex chain.
47+
Additionally, there are other layers on top of Bitcoin that serve different purpose and have their own mechanisms and philosophies like Lightning, RSK, and Liquid.
48+
49+
By taking this layered approach, we are able to have all of the same functionality as chains like Ethereum without all of the drawbacks of having a massively complex chain.
50+
51+
So Stacks is a Bitcoin layer 2 with some unique properties, like having its own token, that acts as an incentive mechanism to maintain a historical ledger of all of its transactions and operate with its own security budget.
6552

66-
So Stacks is a Bitcoin layer with some unique properties, like having its own token, that allow it to maintain a historical ledger of all of its transactions and operate with its own security budget.
53+
The only alternative to this model is a federated model like what Liquid uses. Stacks' design decisions operate under the idea that decentralization is more important than rejecting altcoins.
6754

6855
This is one of the things that separates Stacks from other Bitcoin layers like Lightning.
6956

@@ -79,7 +66,7 @@ This is an important property when we are talking about building blockchains tha
7966

8067
_Sounds like a sidechain_.
8168

82-
Nope. We'll get into the technical details of how this works in the next section, but because Stacks records its entire history to Bitcoin, it is at least as hard to re-org the Stacks chain as it is Bitcoin. This is a key differentiator from side chains, which do not have their history recorded to their primary chain.
69+
Not quite. We'll get into the technical details of how this works in the next section, but because Stacks records its entire history to Bitcoin, it is at least as hard to re-org the Stacks chain as it is Bitcoin. This is a key differentiator from side chains, which do not have their history recorded to their primary chain.
8370

8471
Second, Stacks has its own token, it does not represent pegged Bitcoin. While this may ruffle some feathers among some people in the Bitcoin community, it has several advantages.
8572

0 commit comments

Comments
 (0)