corda/docs/source/index.rst

137 lines
4.3 KiB
ReStructuredText
Raw Normal View History

Welcome to the Corda documentation!
===================================
.. warning:: This build of the docs is from the "|version|" branch, not a milestone release. It may not reflect the
2017-02-22 10:52:47 +00:00
current state of the code. `Read the docs for milestone release M8.2 <https://docs.corda.net/releases/release-M8.2/>`_.
`Corda <https://www.corda.net/>`_ is an open-source distributed ledger platform. The latest *milestone* (i.e. stable)
2017-02-22 10:52:47 +00:00
release is M8.2. The codebase is on `GitHub <https://github.com/corda>`_, and our community can be found on
`Slack <https://slack.corda.net/>`_ and in our `forum <https://discourse.corda.net/>`_.
2016-08-11 12:57:41 +00:00
If you're new to Corda, you should start by learning about its motivating vision and architecture. A good introduction
is the `Introduction to Corda webinar <https://vimeo.com/192757743/c2ec39c1e1>`_ and the `Introductory white paper`_. As
they become more familiar with Corda, readers with a technical background will also want to dive into the `Technical white paper`_,
which describes the platform's envisioned end-state.
Corda is designed so that developers can easily extend its functionality by writing CorDapps
(**Cor**\ da **D**\ istributed **App**\ lication\ **s**\ ). Some example CorDapps are available in the Corda repo's
`samples <https://github.com/corda/corda/tree/master/samples>`_ directory. To run these yourself, make
sure you follow the instructions in :doc:`getting-set-up`, then go to
:doc:`running-the-demos`.
If, after running the demos, you're interested in writing your own CorDapps, you can use the
`CorDapp template <https://github.com/corda/cordapp-template>`_ as a base. A simple example CorDapp built upon the template is available `here <https://github.com/corda/cordapp-tutorial>`_, and a video primer on basic CorDapp structure is available `here <https://vimeo.com/192797322/aab499b152>`_.
From there, you'll be in a position to start extending the example CorDapp yourself (e.g. by writing new states, contracts,
and/or flows). For this, you'll want to refer to this docsite, and to the `tutorials <https://docs.corda.net/tutorial-contract.html>`_
in particular. If you get stuck, get in touch on `Slack <https://slack.corda.net/>`_ or the `forum <https://discourse.corda.net/>`_.
Once you're familiar with Corda and CorDapp development, we'd encourage you to get involved in the development of the
platform itself. Find out more about `contributing to Corda <https://github.com/corda/corda/wiki/Corda's-Open-Source-Approach>`_.
.. _`Introductory white paper`: _static/corda-introductory-whitepaper.pdf
.. _`Technical white paper`: _static/corda-technical-whitepaper.pdf
Documentation Contents:
=======================
.. toctree::
:maxdepth: 2
2016-11-18 12:17:32 +00:00
:caption: Getting started
inthebox
getting-set-up
getting-set-up-fault-finding
2016-11-18 12:17:32 +00:00
running-the-demos
2016-11-28 11:44:03 +00:00
CLI-vs-IDE
2016-11-18 12:17:32 +00:00
.. toctree::
:maxdepth: 2
:caption: Key concepts
key-concepts
key-concepts-ecosystem
key-concepts-data-model
key-concepts-core-types
key-concepts-financial-model
key-concepts-flow-framework
key-concepts-consensus-notaries
key-concepts-vault
key-concepts-security-model
.. toctree::
:maxdepth: 2
:caption: CorDapps
creating-a-cordapp
tutorial-cordapp
2016-11-18 12:17:32 +00:00
.. toctree::
:maxdepth: 2
:caption: The Corda node
clientrpc
messaging
persistence
node-administration
corda-configuration-file
corda-plugins
node-services
2016-11-24 16:38:40 +00:00
node-explorer
permissioning
.. toctree::
:maxdepth: 2
:caption: Tutorials
tutorial-contract
2016-07-12 09:24:11 +00:00
tutorial-contract-clauses
2016-07-08 17:33:48 +00:00
tutorial-test-dsl
contract-upgrade
2016-11-25 15:26:00 +00:00
tutorial-integration-testing
tutorial-clientrpc-api
tutorial-building-transactions
2016-11-24 08:21:21 +00:00
flow-state-machines
2016-11-21 17:11:51 +00:00
flow-testing
running-a-notary
using-a-notary
oracles
tutorial-attachments
event-scheduling
.. toctree::
:maxdepth: 2
2016-11-18 12:17:32 +00:00
:caption: Other
2016-11-18 12:17:32 +00:00
network-simulator
clauses
merkle-trees
.. toctree::
:maxdepth: 2
2016-11-18 12:17:32 +00:00
:caption: Component library
2016-11-18 12:17:32 +00:00
contract-catalogue
contract-irs
.. toctree::
:maxdepth: 2
:caption: Appendix
loadtesting
setting-up-a-corda-network
secure-coding-guidelines
release-process
2016-05-24 11:26:17 +00:00
release-notes
2016-01-27 15:01:33 +00:00
codestyle
2016-04-27 17:37:27 +00:00
building-the-docs
further-notes-on-kotlin
2016-12-08 12:14:17 +00:00
publishing-corda
azure-vm
2016-11-18 12:17:32 +00:00
.. toctree::
:maxdepth: 2
:caption: Glossary
2016-11-21 16:00:22 +00:00
glossary