add new FAQ page

This commit is contained in:
Matthias Kretschmann 2017-08-22 01:25:42 +02:00
parent 3a0b694097
commit b5463b0d3f
Signed by: m
GPG Key ID: 606EEEF3C479A91F
5 changed files with 71 additions and 0 deletions

View File

@ -0,0 +1,18 @@
.faq {
padding-top: $spacer * 3;
}
.faq__question {
font-size: $font-size-h4;
}
.faq__answer {
}
.faq-contents__title {
font-size: $font-size-h5;
margin-top: $spacer / 2;
margin-bottom: $spacer / 2;
color: $brand-main-gray-lighter;
}

View File

@ -61,5 +61,6 @@
@import 'page-cla';
@import 'page-partners';
@import 'page-enterprise';
@import 'page-faq';
@import 'ipdb';
@import '9984';

26
_src/_data/faq.yml Normal file
View File

@ -0,0 +1,26 @@
- question: How does BigchainDB provide decentralized control?
answer: "The BigchainDB server software runs on each server in a cluster. One key requirement is that every node in the cluster should be owned and operated by a different person or organization. The degree of democracy or autocracy can vary and is something enforced by the organization overseeing the cluster. Ideally, the nodes should be located in many countries, legal jurisdictions and hosting providers, so an issue with one doesnt affect them all. The only people who can create a valid transfer transaction are the people with the necessary private keys. Nobody else, including node operators, can do that: the power to transact is decentralized."
- question: How is BigchainDB immutable?
answer: "Within BigchainDB, all data is copied to several different places. The higher the replication factor, set by the consortium, the more difficult it becomes to change or delete all replicas. All nodes also monitor all changes so if some unauthorized change happens, appropriate action can be taken. Cryptographic signatures and hashes are also extensively used. In BigchainDB, each transaction must be signed, each block is signed by the node that created it, and each vote is signed by the node that cast it."
- question: How does BigchainDB provide Sybil tolerance?
answer: "BigchainDB is run within federations, where the governing organization behind the network knows and controls who they allow to operate the nodes. Theres no way for one entity to add additional nodes without the permission of the federation. Hosting diversity also protects against a Sybil attack. It prevents any one hosting company from taking control of a majority of nodes. If a hosting company did spin up a new node using the private key already in their hosting infrastructure, the database would have to be reconfigured, alerting the federation about the new node."
- question: What are Native Assets?
answer: "BigchainDB has a built-in concept of assets, along with built-in transaction validity checking. Every BigchainDB transaction is a JSON document with a data structure in which “assets” and “asset transfers” are first-class, fully-supported concepts. A transaction can be used to “create” an asset. A transaction can also be used to transfer an asset from one public key to another. In BigchainDB, the person who holds the private key associated with the current owners public key is the owner of the asset linked to that public key. BigchainDB makes sure that only the owner of an asset can transfer that asset. BigchainDB also allows more complicated ownership and control structures. For example, an asset transfer might be enabled if any two of three controllers allow it."
- question: Is BigchainDB Byzantine Fault Tolerant (BFT)?
answer: "BigchainDB is not currently BFT. It will be offered as an option in future releases with the expectation that turning it on will come at a cost to performance. Full BFT does not scale, and in most practical systems is not necessary. BigchainDB handles crashes and many arbitrary failures. BigchainDB takes a pragmatic approach to security and fault tolerance by adding many security features, including verification of every transaction by all federation nodes and immutability. All federations and nodes are advised to follow best-in-class security standards and regularly run internal tests."
- question: How do I try BigchainDB?
answer: "If you want to try BigchainDB, then you need a BigchainDB cluster to connect to. One option is to install a single-node BigchainDB cluster on your local machine. The [Quickstart](https://docs.bigchaindb.com/projects/server/en/latest/quickstart.html) page in the BigchainDB Server docs has installation instructions. Another option is to connect to an existing BigchainDB cluster, such as the IPDB Test Network. Once you have a BigchainDB cluster to connect to, you can communicate with it via the BigchainDB HTTP API and the WebSocket Event Stream API. To find a list of all tools and libraries, visit the [Get Started](https://www.bigchaindb.com/getstarted/) page."
- question: Is there a public instance of BigchainDB?
answer: "[IPDB](https://ipdb.io)the Interplanetary Database—is a public BigchainDB network. Its made up of two parts: a blockchain database for the world computer and a foundation that guides it. If youre not looking to set up your own federation, you can sign up for IPDB and connect instantly, no installation need. The IPDB caretakers will handle running a BigchainDB network for you."
- question: Can I get a commercial license for BigchainDB?
answer: "BigchainDB has a few different models: consulting for education, ideation and use definition and development; the subscription model, a per node fee for enterprise software billed on an annual contract; or support packages based on a retainer rate. Get more information on BigchainDBs [Enterprise](https://www.bigchaindb.com/enterprise/) page. "
# - question:
# answer: ""

View File

@ -12,6 +12,8 @@ main:
url: https://docs.bigchaindb.com/
secondary:
- title: FAQ
url: "/faq/"
- title: Whitepaper
url: "/whitepaper/"
- title: Blog

24
_src/faq.html Normal file
View File

@ -0,0 +1,24 @@
---
layout: page
title: Frequently answered questions
---
<section class="section section--faq">
<div class="row">
<div class="faq-contents">
{% for faq in site.data.faq %}
<h1 class="faq-contents__title"><a href="#{{ faq.question | downcase | replace: ' ','-' | replace: '?', '' }}">{{ faq.question }}</a></h1>
{% endfor %}
</div>
<div class="faq">
{% for faq in site.data.faq %}
<h1 class="faq__question" id="{{ faq.question | downcase | replace: ' ','-' | replace: '?', '' }}">{{ faq.question }}</h1>
<div class="faq__answer">{{ faq.answer | markdownify }}</div>
{% endfor %}
</div>
</div>
</section>