Commit Graph

56 Commits

Author SHA1 Message Date
Greg Fitzgerald
962e8dca1d Fix markdown 2018-12-12 17:19:46 -07:00
Greg Fitzgerald
8da4be1b34 Prefer the term 'cluster' over 'network'
Use 'network' for the networking stack. Examples:

* The network drops packets.
* The cluster rejects bad transactions.
* The Solana cluster runs on a gigabit network.
2018-12-12 17:19:46 -07:00
Greg Fitzgerald
f2ef74d1a1 Consistent naming between ToC and chapters 2018-12-12 17:19:46 -07:00
Greg Fitzgerald
546c92751b 80-char lines 2018-12-12 17:19:46 -07:00
Greg Fitzgerald
3a89d80a61 Update name in TPU 2018-12-12 14:55:27 -07:00
Greg Fitzgerald
fd45e83651 Add web wallet example 2018-12-12 14:55:27 -07:00
Greg Fitzgerald
9a49ace606 No longer reserve terms from the terminology chapter
We followed the precedent set by the Rust book here, but now that
proposals are integrated, each proposal can simply include its own
terminology section.
2018-12-12 14:12:07 -07:00
Greg Fitzgerald
ad8b095677 Capitalize acronyms in book 2018-12-12 12:15:20 -07:00
Greg Fitzgerald
38c72070fb Update links 2018-12-12 12:11:12 -07:00
Greg Fitzgerald
93fe1af1a8 Integrate EntryTree description into the TVU doc 2018-12-12 12:11:12 -07:00
Greg Fitzgerald
504bf4ba84 Bring drone description into the present 2018-12-12 12:11:12 -07:00
Greg Fitzgerald
9f9c5fcf10 Migrate all RFC content into the book 2018-12-12 12:11:12 -07:00
Greg Fitzgerald
90a0237457 Cherrypick recent changes to gossip RFC
Delete the RFC since this is all implemented.

See: 02bfcd23a9
2018-12-12 11:55:07 -07:00
Greg Fitzgerald
c83538a60c Add new proposal process
And move replication and enclave proposals there to get a feel
for how it'd look.
2018-12-12 11:04:57 -07:00
Greg Fitzgerald
13d4e3f29f Replace the leader rotation chapter with the latest RFC
The content that was originally copied was split into multiple
RFCs, leaving the book copy to bitrot.
2018-12-12 10:48:58 -07:00
Greg Fitzgerald
6cbf82dbe0 Delete storage.md 2018-12-11 17:10:01 -07:00
Greg Fitzgerald
896622de64 Delete empty page
Bring this back in after replication is fully integrated.
2018-12-11 17:09:44 -07:00
Greg Fitzgerald
1a160a86fa Fix typo and curve corners 2018-12-11 17:07:43 -07:00
Greg Fitzgerald
11abd3cf6e Update tictactoe.md 2018-12-11 17:03:49 -07:00
Greg Fitzgerald
9552badb16 Reference tic-tac-toe README instead of copying it
Also expand a bit on how it works.
2018-12-11 16:01:35 -08:00
Greg Fitzgerald
6fd41beccd Reference the JavaScript API docs more directly 2018-12-11 16:01:35 -08:00
Greg Fitzgerald
c679dea1b7 Add instructions to build and run tic-tac-toe 2018-12-11 16:01:35 -08:00
Greg Fitzgerald
9556a9be17 Update the artwork 2018-12-10 15:26:43 -07:00
Rob Walker
586d9ee850 fix some nits (#2034)
rework maybe_cargo_install(), renamed to cargo_install_unless, updated to take a command to attempt
2018-12-08 19:14:19 -08:00
Michael Vines
b1682558a6 Remove optional --identity argument to simplify command 2018-12-08 10:22:51 -08:00
Greg Fitzgerald
b5a80d3d49 Update ledger replication chapter (#2029)
* ledger block -> ledger segment

The book already defines a *block* to be a slight variation of
how block-based changes define it. It's the thing the cluster
confirms should be the next set of transactions on the ledger.

* Boot storage description from the book
2018-12-07 16:52:36 -07:00
Michael Vines
70c149c7da Rename leader/validator to bootstrap-leader/fullnode
Only rsyncing the genesis ledger snuck in here as well
2018-12-06 19:44:47 -08:00
Greg Fitzgerald
97b1156a7a Rename Ncp to GossipService
And BroadcastStage to BroadcastService since it's not included in the
TPU pipeline.
2018-12-06 15:48:19 -07:00
Greg Fitzgerald
a20c1b4547 Apply review feedback
And take a stab at clarifying some other sections too.
2018-12-06 08:44:01 -07:00
Greg Fitzgerald
56ffb4385d Use gossip RFC to seed the NCP description
And format the gossip RFC for easy diffing.
2018-12-06 08:44:01 -07:00
Michael Vines
a6312ba98f Switch snap to bootstrap-fullnode/fullnode naming 2018-12-05 18:59:43 -08:00
Greg Fitzgerald
b880dafe28 Cleanup intro 2018-12-05 15:25:11 -08:00
Rob Walker
4fd4218178 update terminology before tearing into RFCs (#1995)
update terminology before tearing into RFCs
2018-12-05 14:35:41 -08:00
Greg Fitzgerald
a29b307554 Reorg programming model to be more top-down
First explain how a client interacts with existing programs and why
you'd do that. Next, mention that users can contribute their own programs.
Then explain how those programs can be written in any language.
Finally, mention persistent storage, which is only needed by
stateful programs.
2018-12-05 13:36:43 -08:00
Greg Fitzgerald
bf2658cee0 Apply review feedback 2018-12-05 10:30:16 -08:00
Greg Fitzgerald
6ecb00a1d8 Add account access rules 2018-12-05 10:30:16 -08:00
Greg Fitzgerald
1990501786 Describe executable and owner account metadata 2018-12-05 10:30:16 -08:00
Greg Fitzgerald
963de90b7f Apply review feedback 2018-12-05 10:30:16 -08:00
Greg Fitzgerald
13c7c3b3a6 Rewrite programming model with developer focus
Previous version talked about concurrency, which is described
in detail in the Anatomy of a Fullnode chapter. App developers
probably don't care that their programs run in parallel with
other programs. From their perspective, there's no difference
between 10x parallelism and a 10x faster CPU.
2018-12-05 10:30:16 -08:00
Greg Fitzgerald
209040e80e Free up term "finality" to imply "economic finality" (#2002)
* leader finality -> confirmation

Free up term "finality" to imply "economic finality."

* Reorder chapters
2018-12-04 20:52:38 -07:00
Greg Fitzgerald
da44b0f0f6 Move markdown book theme to its default directory
It was getting in the way of my "git grep".
2018-12-04 10:14:41 -08:00
Greg Fitzgerald
f8aa806d77 Explain how ledger broadcasting works (#1960) 2018-12-02 16:43:40 -07:00
Michael Vines
42dc18ddfc Avoid exiting when cmd is not found 2018-11-30 20:44:34 -08:00
Manuel
801df72680 h4,h5 font size increased 2018-11-30 18:03:55 -08:00
Manuel
c8f161d17f a custom mdbook theme implemented to improve book style and structure 2018-11-30 18:03:55 -08:00
Greg Fitzgerald
99445f475b Add leader rotation links
Avoid the term "leader selection" here. More precise terms are
"leader scheduling", "leader rotation", and "fork selection."
2018-11-28 18:08:05 -08:00
Greg Fitzgerald
070d6a2faa Drop mention of CLI tooling
This is a "how does it work?" chapter, not "how do I do it?"
2018-11-28 18:08:05 -08:00
Greg Fitzgerald
3de63570f6 Better formatting and lots of terminology links 2018-11-28 18:08:05 -08:00
Greg Fitzgerald
8d1ac37734 More terms 2018-11-28 18:08:05 -08:00
Greg Fitzgerald
36503ead70 Fix capitalization
And delete JSON RPC Service for now, since it currently has no
content.
2018-11-28 18:08:05 -08:00