From 3b94ab8ffddf192e76ea71693cfdea11a4137a30 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:02:09 -0500 Subject: [PATCH 01/14] fix removed glossary link --- documents/partials/overview/lbrycrd.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/partials/overview/lbrycrd.md b/documents/partials/overview/lbrycrd.md index 1e70068..427ab1c 100644 --- a/documents/partials/overview/lbrycrd.md +++ b/documents/partials/overview/lbrycrd.md @@ -4,7 +4,7 @@ LBRY uses a public, proof-of-work blockchain that is very similar to Bitcoin. Th The most salient feature of the LBRY blockchain is the association of a normalized string of characters (a "name") with a structured set of metadata. This coupling is called a [[claim]]. The content referenced by a claim can be accessed as a LBRY URL, e.g. [lbry://hellolbry](/playground?url=hellolbry). -The LBRY blockchain stores names and metadata in a parallel [[Merkle tree]], separate from the tree used to store transaction data. This allows LBRY URLs to be trustfully resolved even without a full copy of the blockchain. +The LBRY blockchain stores names and metadata in a parallel [Merkle tree](/resources/claimtrie), separate from the tree used to store transaction data. This allows LBRY URLs to be trustfully resolved even without a full copy of the blockchain. The metadata contains information about the content, such as the title, creator, price (if any), and a unique signature allowing the actual content to be fetched from the data network, the next level in the LBRY stack. -- 2.45.2 From a2df45098288237aa0d0c93a313c0360141ca9e2 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:06:08 -0500 Subject: [PATCH 02/14] Update chainquery.md --- documents/partials/overview/chainquery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/partials/overview/chainquery.md b/documents/partials/overview/chainquery.md index fb81834..1482477 100644 --- a/documents/partials/overview/chainquery.md +++ b/documents/partials/overview/chainquery.md @@ -1,3 +1,3 @@ -Chainquery is a tool to facilitate simple and efficient access to the data contained within the LBRY blockchain. +[[Chainquery]] is a tool to facilitate simple and efficient access to the data contained within the LBRY blockchain. Chainquery is a special type of full blockchain node that monitors and parses transactions into an SQL database. It also adds convenience columns and tables designed for common use cases. -- 2.45.2 From 49ce6a17618f9f900c7f9ec3e99675e6ef01835d Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:11:08 -0500 Subject: [PATCH 03/14] Update lbrysdk.md --- documents/partials/overview/lbrysdk.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documents/partials/overview/lbrysdk.md b/documents/partials/overview/lbrysdk.md index 8485e0c..63e1614 100644 --- a/documents/partials/overview/lbrysdk.md +++ b/documents/partials/overview/lbrysdk.md @@ -1,10 +1,10 @@ -While the blockchain is the innovation that makes LBRY _possible_, the Data Network is the layer that actually makes the blockchain _useful_. +While the blockchain is the innovation that makes LBRY _possible_, the [Data Network](/spec#data) is the layer that actually makes the blockchain _useful_. At this level: -- Metadata stored in the blockchain is interpreted and validated. -- Data referenced by metadata is accessed and distributed via a peer-to-peer network. -- [[Identities]] are created, signed, and validated. +- [Metadata](/spec#metadata] stored in the blockchain is interpreted and validated. +- [Data referenced by metadata](/spec#data) is accessed and distributed via a peer-to-peer network. +- [Identities](/spec#channels) are created, signed, and validated. Data network operations are provided by the [lbrysdk](https://github.com/lbryio/lbry). This SDK also provides local wallet functionality and a set of APIs to facilitate building applications. -- 2.45.2 From bf4ca3a8ffb8576cb23ea8f0939cc799e7c1098a Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:11:36 -0500 Subject: [PATCH 04/14] Update lighthouse.md --- documents/partials/overview/lighthouse.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/partials/overview/lighthouse.md b/documents/partials/overview/lighthouse.md index acfddaf..eb498f1 100644 --- a/documents/partials/overview/lighthouse.md +++ b/documents/partials/overview/lighthouse.md @@ -1 +1 @@ -Lighthouse is a fast, advanced search engine for searching metadata stored in the LBRY blockchain. +Lighthouse is a fast, advanced search engine for searching [metadata](/spec#metadata) stored in the LBRY blockchain. -- 2.45.2 From 4bc2e78dafd90a3e8d2ae22648a5be82dbaaa38a Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:12:12 -0500 Subject: [PATCH 05/14] Update reflector.md --- documents/partials/overview/reflector.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/partials/overview/reflector.md b/documents/partials/overview/reflector.md index 6e019d6..5a27324 100644 --- a/documents/partials/overview/reflector.md +++ b/documents/partials/overview/reflector.md @@ -1 +1 @@ -Reflectors are a special class of hosting servers that facilitate end-user publishing. A reflector server (or server cluster) can accept LBRY content for hosting en masse as well as earn blockchain tokens for data fees. +[Reflectors](/spec#reflectors-and-data-markets) are a special class of hosting servers that facilitate end-user publishing. A reflector server (or server cluster) can accept LBRY content for hosting en masse as well as earn blockchain tokens for data fees. -- 2.45.2 From 97ec773002329302cf7aa64de955fd49a5567159 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:19:44 -0500 Subject: [PATCH 06/14] Update claimtrie.md --- documents/resources/claimtrie.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documents/resources/claimtrie.md b/documents/resources/claimtrie.md index 7c67bf0..ad9107d 100644 --- a/documents/resources/claimtrie.md +++ b/documents/resources/claimtrie.md @@ -3,9 +3,9 @@ title: Merkle Claim Trie description: Publishes to the LBRY network get placed into a Merkle Claim Trie. Learn what that is and why trie is not a typo in this resource article. --- -How the data structure that organizes claims by names works, how proofs are generated/verified and how consensus on the state of the trie is represented. +This article will discuss how the data structures that organize claims by names work, proofs are generated/verified, and consensus on the state of the trie is represented. -For looking into how claims end up in the trie, [read this instead](https://lbry.io/faq/claimtrie-implementation). +For looking into how claims end up in the trie, [read this instead](/spec#claimtrie). ## The Trie -- 2.45.2 From 4c178ba33a4d4f8479e0755c5909c738b0a1aed4 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:20:35 -0500 Subject: [PATCH 07/14] Update consensus.md --- documents/resources/consensus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/resources/consensus.md b/documents/resources/consensus.md index 147e2f1..178c7f0 100644 --- a/documents/resources/consensus.md +++ b/documents/resources/consensus.md @@ -3,7 +3,7 @@ title: Consensus Algorithm description: How does the LBRY blockchain achieve consensus? This resource page will explain. --- -LBRY uses [proof of work](https://en.bitcoin.it/wiki/Proof_of_work) as a consensus mechanism, the same way that Bitcoin does. +LBRY uses [proof of work](https://en.bitcoin.it/wiki/Proof_of_work) as a [consensus mechanism](/spec#consensus), the same way that Bitcoin does. LBRY has differences in hash function, block targeting, and difficult adjustment. -- 2.45.2 From 5526d0e5dace437c2c8d73fbaf23fc378773c93d Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:21:43 -0500 Subject: [PATCH 08/14] Update download-overview.md --- documents/resources/download-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/resources/download-overview.md b/documents/resources/download-overview.md index d454d6b..346740e 100644 --- a/documents/resources/download-overview.md +++ b/documents/resources/download-overview.md @@ -7,7 +7,7 @@ This resource outlines the step-by-step process of using the LBRY protocol to do ## Getting Started -Downloading spans the three core components of LBRY (blockchain, DHT, blob exchange) and explains the structure of the claim metadata and the blobs that make up a LBRY stream. +Downloading spans the three core components of LBRY (blockchain, DHT, blob exchange) and explains the structure of the [claim metadata](/spec#metadata) and the blobs that make up a [LBRY stream](/spec#data). You will need: -- 2.45.2 From 25eb44f87d2e275afa57331976c0478f575cbee2 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:23:59 -0500 Subject: [PATCH 09/14] Update contribute.md --- documents/contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/contribute.md b/documents/contribute.md index c0876d5..90d6d31 100644 --- a/documents/contribute.md +++ b/documents/contribute.md @@ -13,7 +13,7 @@ Contributors that provide accepted pull requests, well-specified issues, or assi ## Repository Overview -Typical usage of LBRY does not involve a single piece of software, but several interacting components. If you're new to LBRY, our [Ecosystem Overview](/overview#ecosystem-overview) will teach you how various components interact. +Typical usage of LBRY does not involve a single piece of software, but several interacting components. If you're new to LBRY, our [Ecosystem Overview](/overview#ecosystem-overview) will teach you how various components interact. For more technical details, see our [spec](/spec). If you want to contribute to LBRY, there's definitely something for you! The first step is to figure out what project to work on. -- 2.45.2 From 809599e853e98235c35f078f60ba8651be1abe90 Mon Sep 17 00:00:00 2001 From: Thomas Zarebczan Date: Fri, 15 Feb 2019 13:26:52 -0500 Subject: [PATCH 10/14] Update build.md --- documents/build.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documents/build.md b/documents/build.md index ca42e4f..3689be5 100644 --- a/documents/build.md +++ b/documents/build.md @@ -10,7 +10,7 @@ description: Learn how to build your own app via LBRY in this comprehensive guid Want to build something on top of LBRY? This is the place to get started. At least, it's the place to get started so long as you have some idea of what LBRY _is_. If you don't, you should read the -[Overview](/overview) first. +[Overview](/overview) first and the [spec](/spec) for more technical details. Want to build with us rather than on your own? Check out our [Contributing Guide](/contribute). @@ -18,7 +18,7 @@ Want to build with us rather than on your own? Check out our [Contributing Guide - You want to build an application that contributes to the world's knowledge, or benefits from global, shared discovery. - You want to replace an existing centralized service related to digital content distribution with a decentralized or community-controlled one. -- You want to build an application that is [[permissionless]] to interact with. +- You want to build an application that is permissionless to interact with. - You want to further openness, freedom of information, and/or personal choice on the internet. ### When Not to Use LBRY -- 2.45.2 From 3a5da688930feb4d7c0852359f6216d4798d16ab Mon Sep 17 00:00:00 2001 From: Alex Grin Date: Tue, 19 Feb 2019 13:08:25 -0500 Subject: [PATCH 11/14] Update build.md --- documents/build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/build.md b/documents/build.md index 3689be5..3855e3d 100644 --- a/documents/build.md +++ b/documents/build.md @@ -10,7 +10,7 @@ description: Learn how to build your own app via LBRY in this comprehensive guid Want to build something on top of LBRY? This is the place to get started. At least, it's the place to get started so long as you have some idea of what LBRY _is_. If you don't, you should read the -[Overview](/overview) first and the [spec](/spec) for more technical details. +[Overview](/overview) and the [spec](/spec) for more technical details. Want to build with us rather than on your own? Check out our [Contributing Guide](/contribute). -- 2.45.2 From 04a73d58f3e7b1c9b361336de6077061adc5907a Mon Sep 17 00:00:00 2001 From: Alex Grin Date: Tue, 19 Feb 2019 13:09:14 -0500 Subject: [PATCH 12/14] Update contribute.md --- documents/contribute.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/contribute.md b/documents/contribute.md index 90d6d31..c0876d5 100644 --- a/documents/contribute.md +++ b/documents/contribute.md @@ -13,7 +13,7 @@ Contributors that provide accepted pull requests, well-specified issues, or assi ## Repository Overview -Typical usage of LBRY does not involve a single piece of software, but several interacting components. If you're new to LBRY, our [Ecosystem Overview](/overview#ecosystem-overview) will teach you how various components interact. For more technical details, see our [spec](/spec). +Typical usage of LBRY does not involve a single piece of software, but several interacting components. If you're new to LBRY, our [Ecosystem Overview](/overview#ecosystem-overview) will teach you how various components interact. If you want to contribute to LBRY, there's definitely something for you! The first step is to figure out what project to work on. -- 2.45.2 From 52aa8d002ec395bab4739ec9565f6d21beb80948 Mon Sep 17 00:00:00 2001 From: Alex Grin Date: Tue, 19 Feb 2019 13:09:46 -0500 Subject: [PATCH 13/14] Update chainquery.md --- documents/partials/overview/chainquery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/partials/overview/chainquery.md b/documents/partials/overview/chainquery.md index 1482477..fb81834 100644 --- a/documents/partials/overview/chainquery.md +++ b/documents/partials/overview/chainquery.md @@ -1,3 +1,3 @@ -[[Chainquery]] is a tool to facilitate simple and efficient access to the data contained within the LBRY blockchain. +Chainquery is a tool to facilitate simple and efficient access to the data contained within the LBRY blockchain. Chainquery is a special type of full blockchain node that monitors and parses transactions into an SQL database. It also adds convenience columns and tables designed for common use cases. -- 2.45.2 From 9b2d583f739788a66732997329357aef0d02d248 Mon Sep 17 00:00:00 2001 From: Alex Grin Date: Tue, 19 Feb 2019 13:10:36 -0500 Subject: [PATCH 14/14] Update claimtrie.md --- documents/resources/claimtrie.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documents/resources/claimtrie.md b/documents/resources/claimtrie.md index ad9107d..95acb7c 100644 --- a/documents/resources/claimtrie.md +++ b/documents/resources/claimtrie.md @@ -3,7 +3,7 @@ title: Merkle Claim Trie description: Publishes to the LBRY network get placed into a Merkle Claim Trie. Learn what that is and why trie is not a typo in this resource article. --- -This article will discuss how the data structures that organize claims by names work, proofs are generated/verified, and consensus on the state of the trie is represented. +This article will discuss how the data structures that organize claims by names work, how proofs are generated/verified, and how consensus on the state of the trie is represented. For looking into how claims end up in the trie, [read this instead](/spec#claimtrie). -- 2.45.2