fix docs links & stuff (#1273)

* fix links in docs/spec etc, closes #1261

* spec: remove ref to non-existant repo

* codecov you weirdo
This commit is contained in:
Zach 2018-03-05 20:30:36 +08:00 committed by Anton Kaliaev
parent 3d88612690
commit bdd50c5f37
9 changed files with 20 additions and 31 deletions

View File

@ -16,8 +16,3 @@ comment:
require_changes: no require_changes: no
require_base: no require_base: no
require_head: yes require_head: yes
ignore:
- "docs"
- "*.md"
- "*.rst"

View File

@ -57,7 +57,7 @@ Now run ``abci-cli`` to see the list of commands:
KVStore - First Example KVStore - First Example
--------------------- -----------------------
The ``abci-cli`` tool lets us send ABCI messages to our application, to The ``abci-cli`` tool lets us send ABCI messages to our application, to
help build and debug them. help build and debug them.

View File

@ -41,15 +41,15 @@ templates_path = ['_templates']
# The suffix(es) of source filenames. # The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string: # You can specify multiple suffix as a list of string:
# #
source_suffix = ['.rst', '.md'] #source_suffix = ['.rst', '.md']
# source_suffix = '.rst' source_suffix = '.rst'
# The master toctree document. # The master toctree document.
master_doc = 'index' master_doc = 'index'
# General information about the project. # General information about the project.
project = u'Tendermint' project = u'Tendermint'
copyright = u'2017, The Authors' copyright = u'2018, The Authors'
author = u'Tendermint' author = u'Tendermint'
# The version info for the project you're documenting, acts as replacement for # The version info for the project you're documenting, acts as replacement for
@ -71,7 +71,7 @@ language = None
# List of patterns, relative to source directory, that match files and # List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files. # directories to ignore when looking for source files.
# This patterns also effect to html_static_path and html_extra_path # This patterns also effect to html_static_path and html_extra_path
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'architecture'] exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'architecture', 'specification/new-spec', 'examples']
# The name of the Pygments (syntax highlighting) style to use. # The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx' pygments_style = 'sphinx'
@ -203,6 +203,6 @@ urllib.urlretrieve(tools_repo+tools_branch+'/tm-bench/README.rst', filename=tool
#### abci spec ################################# #### abci spec #################################
abci_repo = "https://raw.githubusercontent.com/tendermint/abci/" abci_repo = "https://raw.githubusercontent.com/tendermint/abci/"
abci_branch = "spec-docs" abci_branch = "develop"
urllib.urlretrieve(abci_repo+abci_branch+'/specification.rst', filename='abci-spec.rst') urllib.urlretrieve(abci_repo+abci_branch+'/specification.rst', filename='abci-spec.rst')

View File

@ -5,7 +5,7 @@ The growing list of applications built using various pieces of the Tendermint st
* https://tendermint.com/ecosystem * https://tendermint.com/ecosystem
We thank the community for their contributions thus far and welcome the addition of new projects. A pull request can be submitted to `this file <https://github.com/tendermint/tendermint/blob/master/docs/ecosystem.rst>`__ to include your project. We thank the community for their contributions thus far and welcome the addition of new projects. A pull request can be submitted to `this file <https://github.com/tendermint/aib-data/blob/master/json/ecosystem.json>`__ to include your project.
Other Tools Other Tools
----------- -----------

View File

@ -71,4 +71,4 @@ Tendermint 201
* Readers might also be interested in the `Cosmos Whitepaper <https://cosmos.network/whitepaper>`__ which describes Tendermint, ABCI, and how to build a scalable, heterogeneous, cryptocurrency network. * Readers might also be interested in the `Cosmos Whitepaper <https://cosmos.network/whitepaper>`__ which describes Tendermint, ABCI, and how to build a scalable, heterogeneous, cryptocurrency network.
* For example applications and related software built by the Tendermint team and other, see the `software ecosystem <https://tendermint.com/ecosystem>`__. * For example applications and related software built by the Tendermint team and other, see the `software ecosystem <https://tendermint.com/ecosystem>`__.
Join the `Cosmos and Tendermint Rocket Chat <https://cosmos.rocket.chat>`__ to ask questions and discuss projects. Join the `community <https://cosmos.network/community>`__ to ask questions and discuss projects.

View File

@ -2,7 +2,7 @@
Specification Specification
############# #############
Here you'll find details of the Tendermint specification. See `the spec repo <https://github.com/tendermint/spec>`__ for upcoming material. Tendermint's types are produced by `godoc <https://godoc.org/github.com/tendermint/tendermint/types>`__. Here you'll find details of the Tendermint specification. Tendermint's types are produced by `godoc <https://godoc.org/github.com/tendermint/tendermint/types>`__.
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2
@ -10,6 +10,7 @@ Here you'll find details of the Tendermint specification. See `the spec repo <ht
specification/block-structure.rst specification/block-structure.rst
specification/byzantine-consensus-algorithm.rst specification/byzantine-consensus-algorithm.rst
specification/configuration.rst specification/configuration.rst
specification/corruption.rst
specification/fast-sync.rst specification/fast-sync.rst
specification/genesis.rst specification/genesis.rst
specification/light-client-protocol.rst specification/light-client-protocol.rst

View File

@ -4,11 +4,6 @@ This is a markdown specification of the Tendermint blockchain.
It defines the base data structures, how they are validated, It defines the base data structures, how they are validated,
and how they are communicated over the network. and how they are communicated over the network.
XXX: this spec is a work in progress and not yet complete - see github
[issues](https://github.com/tendermint/tendermint/issues) and
[pull requests](https://github.com/tendermint/tendermint/pulls)
for more details.
If you find discrepancies between the spec and the code that If you find discrepancies between the spec and the code that
do not have an associated issue or pull request on github, do not have an associated issue or pull request on github,
please submit them to our [bug bounty](https://tendermint.com/security)! please submit them to our [bug bounty](https://tendermint.com/security)!
@ -24,18 +19,16 @@ please submit them to our [bug bounty](https://tendermint.com/security)!
### P2P and Network Protocols ### P2P and Network Protocols
TODO: update links - [The Base P2P Layer](p2p): multiplex the protocols ("reactors") on authenticated and encrypted TCP connections
- [Peer Exchange (PEX)](reactors/pex): gossip known peer addresses so peers can find each other
- [The Base P2P Layer](p2p/README.md): multiplex the protocols ("reactors") on authenticated and encrypted TCP connections - [Block Sync](reactors/block_sync): gossip blocks so peers can catch up quickly
- [Peer Exchange (PEX)](pex/README.md): gossip known peer addresses so peers can find each other - [Consensus](reactors/consensus): gossip votes and block parts so new blocks can be committed
- [Block Sync](block_sync/README.md): gossip blocks so peers can catch up quickly - [Mempool](reactors/mempool): gossip transactions so they get included in blocks
- [Consensus](consensus/README.md): gossip votes and block parts so new blocks can be committed - Evidence: TODO
- [Mempool](mempool/README.md): gossip transactions so they get included in blocks
- [Evidence](evidence/README.md): TODO
### More ### More
- [Light Client](light_client/README.md): TODO - Light Client: TODO
- [Persistence](persistence/README.md): TODO - Persistence: TODO
## Overview ## Overview

View File

@ -31,7 +31,7 @@ Updates (state transitions) happen on timeouts, complete proposals, and 2/3 majo
It receives messages from peers, internal validators and from Timeout Ticker It receives messages from peers, internal validators and from Timeout Ticker
and invokes the corresponding handlers, potentially updating the RoundState. and invokes the corresponding handlers, potentially updating the RoundState.
The details of the protocol (together with formal proofs of correctness) implemented by the Receive Routine are The details of the protocol (together with formal proofs of correctness) implemented by the Receive Routine are
discussed in separate document (see [spec](https://github.com/tendermint/spec)). For understanding of this document discussed in separate document. For understanding of this document
it is sufficient to understand that the Receive Routine manages and updates RoundState data structure that is it is sufficient to understand that the Receive Routine manages and updates RoundState data structure that is
then extensively used by the gossip routines to determine what information should be sent to peer processes. then extensively used by the gossip routines to determine what information should be sent to peer processes.

View File

@ -11,7 +11,7 @@ next block should be; a validator might vote with a `VoteMessage` for a differen
round, enough number of processes vote for the same block, then this block is committed and later round, enough number of processes vote for the same block, then this block is committed and later
added to the blockchain. `ProposalMessage` and `VoteMessage` are signed by the private key of the added to the blockchain. `ProposalMessage` and `VoteMessage` are signed by the private key of the
validator. The internals of the protocol and how it ensures safety and liveness properties are validator. The internals of the protocol and how it ensures safety and liveness properties are
explained [here](https://github.com/tendermint/spec). explained in a forthcoming document.
For efficiency reasons, validators in Tendermint consensus protocol do not agree directly on the For efficiency reasons, validators in Tendermint consensus protocol do not agree directly on the
block as the block size is big, i.e., they don't embed the block inside `Proposal` and block as the block size is big, i.e., they don't embed the block inside `Proposal` and