Commit Graph

60 Commits

Author SHA1 Message Date
anatoly yakovenko a22e1199cf
Add fork selection RFC (#2061)
RFC and simulation for fork generation.
2018-12-14 11:15:23 -08:00
Greg Fitzgerald 79f12d6b55 Move EntryTree back to proposals 2018-12-14 12:12:34 -07:00
Greg Fitzgerald 483f6702a6
Rewrite synchronization chapter (#2156)
* Rewrite synchronization chapter
* Add synchronization terminology
2018-12-14 11:06:53 -07:00
Greg Fitzgerald 3ce3f1adc1 Move book dev instructions out of top-level readme 2018-12-13 11:17:11 -07:00
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