mirror of
https://github.com/corda/corda.git
synced 2025-04-12 05:40:48 +00:00
Merged in rnicoll-docs-building (pull request #73)
Add tutorial on building documentation
This commit is contained in:
Ross Nicoll
commit
5ab3756ac2
54
docs/build/html/_sources/building-the-docs.txt
vendored
Normal file
54
docs/build/html/_sources/building-the-docs.txt
vendored
Normal file
@ -0,0 +1,54 @@
|
||||
Building the documentation
|
||||
==========================
|
||||
|
||||
The documentation is under the ``docs`` folder, and is written in reStructuredText format. Documentation in HTML format
|
||||
is pre-generated, as well as code documentation, and this can be done automatically via a provided script.
|
||||
|
||||
Requirements
|
||||
------------
|
||||
|
||||
To build the documentation, you will need:
|
||||
|
||||
* GNU Make
|
||||
* Python and pip (tested with Python 2.7.10)
|
||||
* Dokka: https://github.com/Kotlin/dokka
|
||||
* Sphinx: http://www.sphinx-doc.org/
|
||||
* sphinx_rtd_theme: https://github.com/snide/sphinx_rtd_theme
|
||||
|
||||
The Dokka JAR file needs to be placed under the ``lib`` directory within the ``r3prototyping`` directory, in order for the
|
||||
script to find it, as in:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
r3prototyping/lib/dokka.jar
|
||||
|
||||
Note that to install under OS X El Capitan, you will need to tell pip to install under ``/usr/local``, which can be
|
||||
done by specifying the installation target on the command line:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
sudo -H pip install --install-option '--install-data=/usr/local' Sphinx
|
||||
sudo -H pip install --install-option '--install-data=/usr/local' sphinx_rtd_theme
|
||||
|
||||
Build
|
||||
-----
|
||||
|
||||
Once the requirements are installed, you can automatically build the HTML format user documentation and the API
|
||||
documentation by running the following script:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
scripts/generate-docsite.sh
|
||||
|
||||
Alternatively you can build non-HTML formats from the ``docs`` folder. Change directory to the folder and then run the
|
||||
following to see a list of all available formats:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
make
|
||||
|
||||
For example to produce the documentation in HTML format:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
make html
|
||||
1
docs/build/html/_sources/index.txt
vendored
1
docs/build/html/_sources/index.txt
vendored
@ -47,4 +47,5 @@ Read on to learn:
|
||||
|
||||
visualiser
|
||||
codestyle
|
||||
building-the-docs
|
||||
|
||||
|
||||
25
docs/build/html/_sources/messaging.txt
vendored
25
docs/build/html/_sources/messaging.txt
vendored
@ -94,4 +94,29 @@ sit around waiting for messages to be delivered. Handlers will then be invoked o
|
||||
more difficult style of programming that can be used to increase the realism of the unit tests by ensuring multiple
|
||||
nodes run in parallel, just as they would on a real network spread over multiple machines.
|
||||
|
||||
Network Map Service
|
||||
-------------------
|
||||
|
||||
Supporting the messaging layer is a network map service, which is responsible for tracking public nodes on the network.
|
||||
Nodes have an internal component, the network map cache, which contains a copy of the network map. When a node starts up
|
||||
its cache fetches a copy of the full network map, and requests to be notified of changes. The node then registers itself
|
||||
with the network map service, and the service notifies subscribers that a new node has joined the network. Nodes do not
|
||||
automatically deregister themselves, so far (for example) nodes going offline briefly for maintenance
|
||||
|
||||
Nodes submit signed changes to the map service, which then forwards them on to nodes which have requested to be notified
|
||||
of changes. This process achieves basic consensus of the overall network map, although currently it has no formal
|
||||
process for identifying or recovering from issues such as network outages. Later versions are planned to address this.
|
||||
|
||||
Registration change notifications contain a serial number, which indicates their relative ordering, similar to the
|
||||
serial number on DNS records. These numbers must increase with each change, but are not expected to be sequential.
|
||||
Changes are then signed by the party whom the node represents to confirm the association between party and node.
|
||||
The change, signature and public key are then sent to the network map service, which verifies the signature and then
|
||||
updates the network map accordingly.
|
||||
|
||||
The network map cache currently supports:
|
||||
|
||||
* Looking up nodes by service
|
||||
* Looking up node for a party
|
||||
* Suggesting a node providing a specific service, based on suitability for a contract and parties, for example suggesting
|
||||
an appropriate interest rates oracle for a interest rate swap contract. Currently no recommendation logic is in place
|
||||
(the code simply picks the first registered node that supports the required service), however.
|
||||
|
||||
267
docs/build/html/building-the-docs.html
vendored
Normal file
267
docs/build/html/building-the-docs.html
vendored
Normal file
@ -0,0 +1,267 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
|
||||
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>Building the documentation — R3 Prototyping latest documentation</title>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="stylesheet" href="_static/css/custom.css" type="text/css" />
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="top" title="R3 Prototyping latest documentation" href="index.html"/>
|
||||
<link rel="prev" title="Code style guide" href="codestyle.html"/>
|
||||
|
||||
|
||||
<script src="_static/js/modernizr.min.js"></script>
|
||||
|
||||
</head>
|
||||
|
||||
<body class="wy-body-for-nav" role="document">
|
||||
|
||||
<div class="wy-grid-for-nav">
|
||||
|
||||
|
||||
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||
<div class="wy-side-scroll">
|
||||
<div class="wy-side-nav-search">
|
||||
|
||||
|
||||
|
||||
|
||||
<a href="index.html" class="icon icon-home"> R3 Prototyping
|
||||
|
||||
|
||||
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
|
||||
<div class="version">
|
||||
latest
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
<div role="search">
|
||||
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
|
||||
<input type="text" name="q" placeholder="Search docs" />
|
||||
<input type="hidden" name="check_keywords" value="yes" />
|
||||
<input type="hidden" name="area" value="default" />
|
||||
</form>
|
||||
</div>
|
||||
|
||||
|
||||
<br>
|
||||
<a href="api/index.html">API reference</a>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
||||
|
||||
|
||||
|
||||
<p class="caption"><span class="caption-text">Overview</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="inthebox.html">What’s included?</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="getting-set-up.html">Getting set up</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="data-model.html">Data model</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="messaging.html">Networking and messaging</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="irs.html">The Interest Rate Swap Contract</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Tutorials</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Writing a contract</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="protocol-state-machines.html">Protocol state machines</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="oracles.html">Writing oracle services</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Appendix</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1"><a class="reference internal" href="visualiser.html">Using the visualiser</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="codestyle.html">Code style guide</a></li>
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="#">Building the documentation</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#requirements">Requirements</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#build">Build</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||||
|
||||
|
||||
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
|
||||
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||||
<a href="index.html">R3 Prototyping</a>
|
||||
</nav>
|
||||
|
||||
|
||||
|
||||
<div class="wy-nav-content">
|
||||
<div class="rst-content">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
||||
<ul class="wy-breadcrumbs">
|
||||
<li><a href="index.html">Docs</a> »</li>
|
||||
|
||||
<li>Building the documentation</li>
|
||||
<li class="wy-breadcrumbs-aside">
|
||||
|
||||
|
||||
<a href="_sources/building-the-docs.txt" rel="nofollow"> View page source</a>
|
||||
|
||||
|
||||
</li>
|
||||
</ul>
|
||||
<hr/>
|
||||
</div>
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="building-the-documentation">
|
||||
<h1>Building the documentation<a class="headerlink" href="#building-the-documentation" title="Permalink to this headline">¶</a></h1>
|
||||
<p>The documentation is under the <code class="docutils literal"><span class="pre">docs</span></code> folder, and is written in reStructuredText format. Documentation in HTML format
|
||||
is pre-generated, as well as code documentation, and this can be done automatically via a provided script.</p>
|
||||
<div class="section" id="requirements">
|
||||
<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline">¶</a></h2>
|
||||
<p>To build the documentation, you will need:</p>
|
||||
<ul class="simple">
|
||||
<li>GNU Make</li>
|
||||
<li>Python and pip (tested with Python 2.7.10)</li>
|
||||
<li>Dokka: <a class="reference external" href="https://github.com/Kotlin/dokka">https://github.com/Kotlin/dokka</a></li>
|
||||
<li>Sphinx: <a class="reference external" href="http://www.sphinx-doc.org/">http://www.sphinx-doc.org/</a></li>
|
||||
<li>sphinx_rtd_theme: <a class="reference external" href="https://github.com/snide/sphinx_rtd_theme">https://github.com/snide/sphinx_rtd_theme</a></li>
|
||||
</ul>
|
||||
<p>The Dokka JAR file needs to be placed under the <code class="docutils literal"><span class="pre">lib</span></code> directory within the <code class="docutils literal"><span class="pre">r3prototyping</span></code> directory, in order for the
|
||||
script to find it, as in:</p>
|
||||
<div class="highlight-shell"><div class="highlight"><pre><span></span>r3prototyping/lib/dokka.jar
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Note that to install under OS X El Capitan, you will need to tell pip to install under <code class="docutils literal"><span class="pre">/usr/local</span></code>, which can be
|
||||
done by specifying the installation target on the command line:</p>
|
||||
<div class="highlight-shell"><div class="highlight"><pre><span></span>sudo -H pip install --install-option <span class="s1">'--install-data=/usr/local'</span> Sphinx
|
||||
sudo -H pip install --install-option <span class="s1">'--install-data=/usr/local'</span> sphinx_rtd_theme
|
||||
</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="build">
|
||||
<h2>Build<a class="headerlink" href="#build" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Once the requirements are installed, you can automatically build the HTML format user documentation and the API
|
||||
documentation by running the following script:</p>
|
||||
<div class="highlight-shell"><div class="highlight"><pre><span></span>scripts/generate-docsite.sh
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Alternatively you can build non-HTML formats from the <code class="docutils literal"><span class="pre">docs</span></code> folder. Change directory to the folder and then run the
|
||||
following to see a list of all available formats:</p>
|
||||
<div class="highlight-shell"><div class="highlight"><pre><span></span>make
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>For example to produce the documentation in HTML format:</p>
|
||||
<div class="highlight-shell"><div class="highlight"><pre><span></span>make html
|
||||
</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<footer>
|
||||
|
||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||
|
||||
|
||||
<a href="codestyle.html" class="btn btn-neutral" title="Code style guide" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
<hr/>
|
||||
|
||||
<div role="contentinfo">
|
||||
<p>
|
||||
© Copyright 2015, R3 CEV.
|
||||
|
||||
</p>
|
||||
</div>
|
||||
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
||||
|
||||
</footer>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</section>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
var DOCUMENTATION_OPTIONS = {
|
||||
URL_ROOT:'./',
|
||||
VERSION:'latest',
|
||||
COLLAPSE_INDEX:false,
|
||||
FILE_SUFFIX:'.html',
|
||||
HAS_SOURCE: true
|
||||
};
|
||||
</script>
|
||||
<script type="text/javascript" src="_static/jquery.js"></script>
|
||||
<script type="text/javascript" src="_static/underscore.js"></script>
|
||||
<script type="text/javascript" src="_static/doctools.js"></script>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript" src="_static/js/theme.js"></script>
|
||||
|
||||
|
||||
|
||||
|
||||
<script type="text/javascript">
|
||||
jQuery(function () {
|
||||
SphinxRtdTheme.StickyNav.enable();
|
||||
});
|
||||
</script>
|
||||
|
||||
|
||||
</body>
|
||||
</html>
|
||||
3
docs/build/html/genindex.html
vendored
3
docs/build/html/genindex.html
vendored
@ -90,7 +90,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="getting-set-up.html">Getting set up</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="data-model.html">Data model</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="messaging.html">Networking and messaging</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="irs.html">The Interest Rate Swap Contract</a></li>
|
||||
</ul>
|
||||
@ -104,6 +104,7 @@
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="visualiser.html">Using the visualiser</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="codestyle.html">Code style guide</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="building-the-docs.html">Building the documentation</a></li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
22
docs/build/html/index.html
vendored
22
docs/build/html/index.html
vendored
@ -90,7 +90,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="getting-set-up.html">Getting set up</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="data-model.html">Data model</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="messaging.html">Networking and messaging</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="irs.html">The Interest Rate Swap Contract</a></li>
|
||||
</ul>
|
||||
@ -104,6 +104,7 @@
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="visualiser.html">Using the visualiser</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="codestyle.html">Code style guide</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="building-the-docs.html">Building the documentation</a></li>
|
||||
</ul>
|
||||
|
||||
|
||||
@ -186,16 +187,14 @@ prove or disprove the following hypothesis:</p>
|
||||
<li class="toctree-l2"><a class="reference internal" href="messaging.html#messaging-vs-networking">Messaging vs networking</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="messaging.html#interfaces">Interfaces</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="messaging.html#in-memory-implementation">In memory implementation</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="messaging.html#network-map-service">Network Map Service</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="running-the-demos.html#trader-demo">Trader demo</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="running-the-demos.html#irs-demo">IRS demo</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a>
|
||||
<ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="running-the-demos.html#trader-demo">Trader
|
||||
demo</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="running-the-demos.html#irs-demo">IRS demo</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="node-administration.html#monitoring-your-node">Monitoring your node</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="node-administration.html#uploading-and-downloading-attachments">Uploading and downloading attachments</a></li>
|
||||
@ -256,6 +255,11 @@ prove or disprove the following hypothesis:</p>
|
||||
<li class="toctree-l2"><a class="reference internal" href="codestyle.html#assertions-and-errors">4. Assertions and errors</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="building-the-docs.html">Building the documentation</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="building-the-docs.html#requirements">Requirements</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="building-the-docs.html#build">Build</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
35
docs/build/html/messaging.html
vendored
35
docs/build/html/messaging.html
vendored
@ -31,7 +31,7 @@
|
||||
|
||||
|
||||
<link rel="top" title="R3 Prototyping latest documentation" href="index.html"/>
|
||||
<link rel="next" title="Running the demos" href="running-the-demos.html"/>
|
||||
<link rel="next" title="Running the demos" href="running-the-demos.html"/>
|
||||
<link rel="prev" title="Data model" href="data-model.html"/>
|
||||
|
||||
|
||||
@ -94,9 +94,10 @@
|
||||
<li class="toctree-l2"><a class="reference internal" href="#messaging-vs-networking">Messaging vs networking</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#interfaces">Interfaces</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#in-memory-implementation">In memory implementation</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#network-map-service">Network Map Service</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="irs.html">The Interest Rate Swap Contract</a></li>
|
||||
</ul>
|
||||
@ -110,6 +111,7 @@
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="visualiser.html">Using the visualiser</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="codestyle.html">Code style guide</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="building-the-docs.html">Building the documentation</a></li>
|
||||
</ul>
|
||||
|
||||
|
||||
@ -237,6 +239,30 @@ sit around waiting for messages to be delivered. Handlers will then be invoked o
|
||||
more difficult style of programming that can be used to increase the realism of the unit tests by ensuring multiple
|
||||
nodes run in parallel, just as they would on a real network spread over multiple machines.</p>
|
||||
</div>
|
||||
<div class="section" id="network-map-service">
|
||||
<h2>Network Map Service<a class="headerlink" href="#network-map-service" title="Permalink to this headline">¶</a></h2>
|
||||
<p>Supporting the messaging layer is a network map service, which is responsible for tracking public nodes on the network.
|
||||
Nodes have an internal component, the network map cache, which contains a copy of the network map. When a node starts up
|
||||
its cache fetches a copy of the full network map, and requests to be notified of changes. The node then registers itself
|
||||
with the network map service, and the service notifies subscribers that a new node has joined the network. Nodes do not
|
||||
automatically deregister themselves, so far (for example) nodes going offline briefly for maintenance</p>
|
||||
<p>Nodes submit signed changes to the map service, which then forwards them on to nodes which have requested to be notified
|
||||
of changes. This process achieves basic consensus of the overall network map, although currently it has no formal
|
||||
process for identifying or recovering from issues such as network outages. Later versions are planned to address this.</p>
|
||||
<p>Registration change notifications contain a serial number, which indicates their relative ordering, similar to the
|
||||
serial number on DNS records. These numbers must increase with each change, but are not expected to be sequential.
|
||||
Changes are then signed by the party whom the node represents to confirm the association between party and node.
|
||||
The change, signature and public key are then sent to the network map service, which verifies the signature and then
|
||||
updates the network map accordingly.</p>
|
||||
<p>The network map cache currently supports:</p>
|
||||
<ul class="simple">
|
||||
<li>Looking up nodes by service</li>
|
||||
<li>Looking up node for a party</li>
|
||||
<li>Suggesting a node providing a specific service, based on suitability for a contract and parties, for example suggesting</li>
|
||||
</ul>
|
||||
<p>an appropriate interest rates oracle for a interest rate swap contract. Currently no recommendation logic is in place
|
||||
(the code simply picks the first registered node that supports the required service), however.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
@ -245,9 +271,8 @@ nodes run in parallel, just as they would on a real network spread over multiple
|
||||
<footer>
|
||||
|
||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||
|
||||
<a href="running-the-demos.html" class="btn btn-neutral float-right" title="Running the demos" accesskey="n">Next
|
||||
<span class="fa fa-arrow-circle-right"></span></a>
|
||||
|
||||
<a href="running-the-demos.html" class="btn btn-neutral float-right" title="Running the demos" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
||||
|
||||
|
||||
<a href="data-model.html" class="btn btn-neutral" title="Data model" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
||||
|
||||
BIN
docs/build/html/objects.inv
vendored
BIN
docs/build/html/objects.inv
vendored
Binary file not shown.
3
docs/build/html/search.html
vendored
3
docs/build/html/search.html
vendored
@ -89,7 +89,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="getting-set-up.html">Getting set up</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="data-model.html">Data model</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="messaging.html">Networking and messaging</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="running-the-demos.html">Running the demos</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="node-administration.html">Node administration</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="irs.html">The Interest Rate Swap Contract</a></li>
|
||||
</ul>
|
||||
@ -103,6 +103,7 @@
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="visualiser.html">Using the visualiser</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="codestyle.html">Code style guide</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="building-the-docs.html">Building the documentation</a></li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
2
docs/build/html/searchindex.js
vendored
2
docs/build/html/searchindex.js
vendored
File diff suppressed because one or more lines are too long
54
docs/source/building-the-docs.rst
Normal file
54
docs/source/building-the-docs.rst
Normal file
@ -0,0 +1,54 @@
|
||||
Building the documentation
|
||||
==========================
|
||||
|
||||
The documentation is under the ``docs`` folder, and is written in reStructuredText format. Documentation in HTML format
|
||||
is pre-generated, as well as code documentation, and this can be done automatically via a provided script.
|
||||
|
||||
Requirements
|
||||
------------
|
||||
|
||||
To build the documentation, you will need:
|
||||
|
||||
* GNU Make
|
||||
* Python and pip (tested with Python 2.7.10)
|
||||
* Dokka: https://github.com/Kotlin/dokka
|
||||
* Sphinx: http://www.sphinx-doc.org/
|
||||
* sphinx_rtd_theme: https://github.com/snide/sphinx_rtd_theme
|
||||
|
||||
The Dokka JAR file needs to be placed under the ``lib`` directory within the ``r3prototyping`` directory, in order for the
|
||||
script to find it, as in:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
r3prototyping/lib/dokka.jar
|
||||
|
||||
Note that to install under OS X El Capitan, you will need to tell pip to install under ``/usr/local``, which can be
|
||||
done by specifying the installation target on the command line:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
sudo -H pip install --install-option '--install-data=/usr/local' Sphinx
|
||||
sudo -H pip install --install-option '--install-data=/usr/local' sphinx_rtd_theme
|
||||
|
||||
Build
|
||||
-----
|
||||
|
||||
Once the requirements are installed, you can automatically build the HTML format user documentation and the API
|
||||
documentation by running the following script:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
scripts/generate-docsite.sh
|
||||
|
||||
Alternatively you can build non-HTML formats from the ``docs`` folder. Change directory to the folder and then run the
|
||||
following to see a list of all available formats:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
make
|
||||
|
||||
For example to produce the documentation in HTML format:
|
||||
|
||||
.. sourcecode:: shell
|
||||
|
||||
make html
|
||||
@ -47,4 +47,5 @@ Read on to learn:
|
||||
|
||||
visualiser
|
||||
codestyle
|
||||
building-the-docs
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user