From 178814b2d9dc8ab98b96be626d7e56c4daf442cd Mon Sep 17 00:00:00 2001 From: Mike Hearn Date: Wed, 21 Aug 2019 11:42:08 +0200 Subject: [PATCH] Improve the PDF by giving the book its own short intro page instead of reusing the HTML intro, which doesn't make sense due to HTML-only markup like videos. --- docs/source/index.rst | 54 +++++++++++++++++++++++++++++-------------- 1 file changed, 37 insertions(+), 17 deletions(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index 260bee533b..4820fec128 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,32 +1,52 @@ Welcome to Corda ! ================== -`Corda `_ is an open-source blockchain platform. If you’d like a quick introduction to blockchains and how Corda is different, then watch this short video: +.. only:: html -.. raw:: html + `Corda `_ is an open-source blockchain platform. If you’d like a quick introduction to blockchains and how Corda is different, then watch this short video: - - - + .. raw:: html -Want to see Corda running? Download our demonstration application `DemoBench `_ or -follow our :doc:`quickstart guide `. + + + -If you want to start coding on Corda, then familiarise yourself with the :doc:`key concepts `, then read -our :doc:`Hello, World! tutorial `. For the background behind Corda, read the non-technical + Want to see Corda running? Download our demonstration application `DemoBench `_ or + follow our :doc:`quickstart guide `. + + If you want to start coding on Corda, then familiarise yourself with the :doc:`key concepts `, then read +our :doc:`Hello, World! tutorial `. For the background behind Corda, read the + non-technical `platform white paper`_ or for more detail, the `technical white paper`_. -If you have questions or comments, then get in touch on `Slack `_ or ask a question on -`Stack Overflow `_ . + If you have questions or comments, then get in touch on `Slack `_ or ask a question on + `Stack Overflow `_ . -We look forward to seeing what you can do with Corda! + We look forward to seeing what you can do with Corda! -.. note:: You can read this site offline. Either `download the PDF`_ or download the Corda source code, run ``gradle buildDocs`` and you will have - a copy of this site in the ``docs/build/html`` directory. + .. note:: You can read this site offline. Either `download the PDF`_ or download the Corda source code, run ``gradle buildDocs`` and you will have + a copy of this site in the ``docs/build/html`` directory. -.. _`platform white paper`: _static/corda-platform-whitepaper.pdf -.. _`technical white paper`: _static/corda-technical-whitepaper.pdf -.. _`download the PDF`: _static/corda-developer-site.pdf + .. _`platform white paper`: _static/corda-platform-whitepaper.pdf + .. _`technical white paper`: _static/corda-technical-whitepaper.pdf + .. _`download the PDF`: _static/corda-developer-site.pdf + +.. only:: latex + + Welcome to Corda, a platform for building decentralized applications. This guidebook covers everything you need to know to create + apps, run nodes and networks, and operate your new decentralized business network. + + If you're completely new to distributed ledger technology (DLT) or Corda and would like a business-oriented overview, we recommend + reading the introductory white paper. If you'd like a detailed architectural description of how the Corda protocol works, why + it's designed how it is and what future work is planned, we recommend reading the technical white paper. Both white papers can be + found on `the Corda documentation website`_. + + But if you'd like to dive in and start writing apps, or running nodes, this guidebook is for you. It covers the open source Corda + distribution. Commercial distributions (like Corda Enterprise from R3) have their own user guides that describe their enhanced features. + + We look forward to seeing what you can do with Corda! + + .. _`the Corda documentation website`: https://docs.corda.net .. toctree:: :maxdepth: 1