corda/docs/source/getting-set-up.rst

Getting set up
==============

Software requirements
---------------------
Corda uses industry-standard tools:

* **Oracle JDK 8 JVM** - minimum supported version **8u131**
* **IntelliJ IDEA** - supported versions **2017.1**, **2017.2** and **2017.3**
* **Git**

We also use Gradle and Kotlin, but you do not need to install them. A standalone Gradle wrapper is provided, and it 
will download the correct version of Kotlin.

Please note:

* Corda runs in a JVM. JVM implementations other than Oracle JDK 8 are not actively supported. However, if you do
  choose to use OpenJDK, you will also need to install OpenJFX

* Applications on Corda (CorDapps) can be written in any language targeting the JVM. However, Corda itself and most of
  the samples are written in Kotlin. Kotlin is an
  `official Android language <https://developer.android.com/kotlin/index.html>`_, and you can read more about why
  Kotlin is a strong successor to Java
  `here <https://medium.com/@octskyward/why-kotlin-is-my-next-programming-language-c25c001e26e3>`_. If you're
  unfamiliar with Kotlin, there is an official
  `getting started guide <https://kotlinlang.org/docs/tutorials/>`_, and a series of
  `Kotlin Koans <https://kotlinlang.org/docs/tutorials/koans.html>`_.

* IntelliJ IDEA is recommended due to the strength of its Kotlin integration.

Following these software recommendations will minimize the number of errors you encounter, and make it easier for
others to provide support. However, if you do use other tools, we'd be interested to hear about any issues that arise.

Set-up instructions
-------------------
The instructions below will allow you to set up a Corda development environment and run a basic CorDapp. If you have
any issues, please consult the :doc:`troubleshooting` page, or reach out on `Slack <http://slack.corda.net/>`_,
`Stack Overflow <https://stackoverflow.com/questions/tagged/corda>`_ or the `forums <https://discourse.corda.net/>`_.

The set-up instructions are available for the following platforms:

* :ref:`windows-label` (or `in video form <https://vimeo.com/217462250>`_)

* :ref:`mac-label` (or `in video form <https://vimeo.com/217462230>`_)

.. _windows-label:

Windows
-------

.. warning:: If you are using a Mac machine, please follow the :ref:`mac-label` instructions instead.

Java
^^^^
1. Visit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
2. Scroll down to "Java SE Development Kit 8uXXX" (where "XXX" is the latest minor version number)
3. Toggle "Accept License Agreement"
4. Click the download link for jdk-8uXXX-windows-x64.exe (where "XXX" is the latest minor version number)
5. Download and run the executable to install Java (use the default settings)
6. Open a new command prompt and run ``java -version`` to test that Java is installed correctly

Git
^^^
1. Visit https://git-scm.com/download/win
2. Click the "64-bit Git for Windows Setup" download link.
3. Download and run the executable to install Git (use the default settings)
4. Open a new command prompt and type ``git --version`` to test that git is installed correctly

IntelliJ
^^^^^^^^
1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?code=IIC
2. Download and run the executable to install IntelliJ Community Edition (use the default settings)

Download a sample project
^^^^^^^^^^^^^^^^^^^^^^^^^
1. Open a command prompt
2. Clone the CorDapp example repo by running ``git clone https://github.com/corda/cordapp-example``
3. Move into the cordapp-example folder by running ``cd cordapp-example``

Run from the command prompt
^^^^^^^^^^^^^^^^^^^^^^^^^^^
1. From the cordapp-example folder, deploy the nodes by running ``gradlew deployNodes``
2. Start the nodes by running ``call kotlin-source/build/nodes/runnodes.bat``
3. Wait until all the terminal windows display either "Webserver started up in XX.X sec" or "Node for "NodeC" started up and registered in XX.XX sec"
4. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/

Run from IntelliJ
^^^^^^^^^^^^^^^^^
1. Open IntelliJ Community Edition
2. On the splash screen, click "Open" (do NOT click "Import Project") and select the cordapp-example folder

.. warning:: If you click "Import Project" instead of "Open", the project's run configurations will be erased!

3. Once the project is open, click "File > Project Structure". Under "Project SDK:", set the project SDK by clicking "New...", clicking "JDK", and navigating to C:\\Program Files\\Java\\jdk1.8.0_XXX (where "XXX" is the latest minor version number). Click "OK".
4. Click "View > Tool Windows > Event Log", and click "Import Gradle project", then "OK". Wait, and click "OK" again when the "Gradle Project Data To Import" window appears
5. Wait for indexing to finish (a progress bar will display at the bottom-right of the IntelliJ window until indexing is complete)
6. At the top-right of the screen, to the left of the green "play" arrow, you should see a dropdown. In that dropdown, select "Run Example Cordapp - Kotlin" and click the green "play" arrow.
7. Wait until the run windows displays the message "Webserver started up in XX.X sec"
8. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/

.. _mac-label:

Mac
---

.. warning:: If you are using a Windows machine, please follow the :ref:`windows-label` instructions instead.

Java
^^^^
1. Open "System Preferences > Java"
2. In the Java Control Panel, if an update is available, click "Update Now"
3. In the "Software Update" window, click "Install Update". If required, enter your password and click "Install Helper" when prompted
4. Wait for a pop-up window indicating that you have successfully installed the update, and click "Close"
5. Open a new terminal and type ``java -version`` to test that Java is installed correctly

IntelliJ
^^^^^^^^
1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?platform=mac&code=IIC
2. Download and run the executable to install IntelliJ Community Edition (use the default settings)

Download a sample project
^^^^^^^^^^^^^^^^^^^^^^^^^
1. Open a terminal
2. Clone the CorDapp example repo by running ``git clone https://github.com/corda/cordapp-example``
3. Move into the cordapp-example folder by running ``cd cordapp-example``

Run from the terminal
^^^^^^^^^^^^^^^^^^^^^
1. From the cordapp-example folder, deploy the nodes by running ``./gradlew deployNodes``
2. Start the nodes by running ``kotlin-source/build/nodes/runnodes``. Do not click while 8 additional terminal windows start up.
3. Wait until all the terminal windows display either "Webserver started up in XX.X sec" or "Node for "NodeC" started up and registered in XX.XX sec"
4. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/

Run from IntelliJ
^^^^^^^^^^^^^^^^^
1. Open IntelliJ Community Edition
2. On the splash screen, click "Open" (do NOT click "Import Project") and select the cordapp-example folder
3. Once the project is open, click "File > Project Structure". Under "Project SDK:", set the project SDK by clicking "New...", clicking "JDK", and navigating to /Library/Java/JavaVirtualMachines/jdk1.8.0_XXX (where "XXX" is the latest minor version number). Click "OK".
4. Click "View > Tool Windows > Event Log", and click "Import Gradle project", then "OK". Wait, and click "OK" again when the "Gradle Project Data To Import" window appears
5. Wait for indexing to finish (a progress bar will display at the bottom-right of the IntelliJ window until indexing is complete)
6. At the top-right of the screen, to the left of the green "play" arrow, you should see a dropdown. In that dropdown, select "Run Example Cordapp - Kotlin" and click the green "play" arrow.
7. Wait until the run windows displays the message "Webserver started up in XX.X sec"
8. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/

Corda source code
-----------------

The Corda platform source code is available here:

    https://github.com/corda/corda.git

A CorDapp template that you can use as the basis for your own CorDapps is available in both Java and Kotlin versions:

    https://github.com/corda/cordapp-template-java.git

    https://github.com/corda/cordapp-template-kotlin.git

And a list of simple sample CorDapps for you to explore basic concepts is available here:

	https://www.corda.net/samples/

You can clone these repos to your local machine by running the command ``git clone [repo URL]``.

Next steps
----------
The best way to check that everything is working fine is by taking a deeper look at the
:doc:`example CorDapp <tutorial-cordapp>`.

Next, you should read through :doc:`Corda Key Concepts <key-concepts>` to understand how Corda works.

By then, you'll be ready to start writing your own CorDapps. Learn how to do this in the
:doc:`Hello, World tutorial <hello-world-introduction>`. You may want to refer to the :doc:`API docs <api-index>`, the
:doc:`flow cookbook <flow-cookbook>` and the `samples <https://www.corda.net/samples/>`_ along the way.

If you encounter any issues, please see the :doc:`troubleshooting` page, or get in touch with us on the
`forums <https://discourse.corda.net/>`_ or via `slack <http://slack.corda.net/>`_.
Introduce documentation of the current prototype with a contract programming tutorial (incomplete), using the Sphinx docs engine. Actual generated HTML will follow in the next commit. 2015-11-25 13:27:07 +00:00			`Getting set up`
			`==============`

Provides clearer instructions on the 'Getting set up' page. Expands 'Troubleshooting' page. 2017-01-31 12:59:24 +00:00			`Software requirements`
			`---------------------`
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`Corda uses industry-standard tools:`
First revision for 'getting set up' - docs not rebuilt as to keep changes visible 2016-11-14 18:12:39 +00:00
Update getting-set-up.rst. 2017-08-30 12:20:11 +00:00			`* Oracle JDK 8 JVM - minimum supported version 8u131`
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`* IntelliJ IDEA - supported versions 2017.1, 2017.2 and 2017.3`
			`* Git`
Introduce documentation of the current prototype with a contract programming tutorial (incomplete), using the Sphinx docs engine. Actual generated HTML will follow in the next commit. 2015-11-25 13:27:07 +00:00
Update getting-set-up.rst. 2017-08-30 12:20:11 +00:00			`We also use Gradle and Kotlin, but you do not need to install them. A standalone Gradle wrapper is provided, and it`
			`will download the correct version of Kotlin.`
Docs: warn about IntelliJ issue that causes .idea to be wiped at import time 2016-11-29 15:53:35 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`Please note:`
Improve Set Up documentation - there seems to be some changes to IntelliJ - some further clarification 2016-05-18 09:39:47 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`* Corda runs in a JVM. JVM implementations other than Oracle JDK 8 are not actively supported. However, if you do`
			`choose to use OpenJDK, you will also need to install OpenJFX`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`* Applications on Corda (CorDapps) can be written in any language targeting the JVM. However, Corda itself and most of`
			`the samples are written in Kotlin. Kotlin is an`
			`official Android language <https://developer.android.com/kotlin/index.html>`_, and you can read more about why
			`Kotlin is a strong successor to Java`
			`here <https://medium.com/@octskyward/why-kotlin-is-my-next-programming-language-c25c001e26e3>`_. If you're
			`unfamiliar with Kotlin, there is an official`
			`getting started guide <https://kotlinlang.org/docs/tutorials/>`_, and a series of
			`Kotlin Koans <https://kotlinlang.org/docs/tutorials/koans.html>`_.
Improve Set Up documentation - there seems to be some changes to IntelliJ - some further clarification 2016-05-18 09:39:47 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`* IntelliJ IDEA is recommended due to the strength of its Kotlin integration.`
Provides clearer instructions on the 'Getting set up' page. Expands 'Troubleshooting' page. 2017-01-31 12:59:24 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			`Following these software recommendations will minimize the number of errors you encounter, and make it easier for`
			`others to provide support. However, if you do use other tools, we'd be interested to hear about any issues that arise.`
Introduce documentation of the current prototype with a contract programming tutorial (incomplete), using the Sphinx docs engine. Actual generated HTML will follow in the next commit. 2015-11-25 13:27:07 +00:00
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`Set-up instructions`
			`-------------------`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`The instructions below will allow you to set up a Corda development environment and run a basic CorDapp. If you have`
			any issues, please consult the :doc:`troubleshooting` page, or reach out on `Slack <http://slack.corda.net/>`_,
			`Stack Overflow <https://stackoverflow.com/questions/tagged/corda>`_ or the `forums <https://discourse.corda.net/>`_.
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`The set-up instructions are available for the following platforms:`

			* :ref:`windows-label` (or `in video form <https://vimeo.com/217462250>`_)

			* :ref:`mac-label` (or `in video form <https://vimeo.com/217462230>`_)

			`.. _windows-label:`
Adds video links to the Getting Set Up page. (#683) 2017-05-15 10:18:26 +00:00
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`Windows`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`-------`

			.. warning:: If you are using a Mac machine, please follow the :ref:`mac-label` instructions instead.
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
			`Java`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Visit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html`
			`2. Scroll down to "Java SE Development Kit 8uXXX" (where "XXX" is the latest minor version number)`
			`3. Toggle "Accept License Agreement"`
			`4. Click the download link for jdk-8uXXX-windows-x64.exe (where "XXX" is the latest minor version number)`
			`5. Download and run the executable to install Java (use the default settings)`
			6. Open a new command prompt and run ``java -version`` to test that Java is installed correctly

			`Git`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Visit https://git-scm.com/download/win`
			`2. Click the "64-bit Git for Windows Setup" download link.`
			`3. Download and run the executable to install Git (use the default settings)`
			4. Open a new command prompt and type ``git --version`` to test that git is installed correctly

			`IntelliJ`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?code=IIC`
			`2. Download and run the executable to install IntelliJ Community Edition (use the default settings)`

			`Download a sample project`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Open a command prompt`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			2. Clone the CorDapp example repo by running ``git clone https://github.com/corda/cordapp-example``
			3. Move into the cordapp-example folder by running ``cd cordapp-example``
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
			`Run from the command prompt`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^^^^^^^^^^^`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			1. From the cordapp-example folder, deploy the nodes by running ``gradlew deployNodes``
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			2. Start the nodes by running ``call kotlin-source/build/nodes/runnodes.bat``
			`3. Wait until all the terminal windows display either "Webserver started up in XX.X sec" or "Node for "NodeC" started up and registered in XX.XX sec"`
			`4. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/`

			`Run from IntelliJ`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Open IntelliJ Community Edition`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			`2. On the splash screen, click "Open" (do NOT click "Import Project") and select the cordapp-example folder`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
			`.. warning:: If you click "Import Project" instead of "Open", the project's run configurations will be erased!`

Properly escape backslashes in windows paths (#1556) * fix some backslashes in the windows paths in the docs This reverts commit 4532bca58009ccba9d5d2ac97cb2a62c35770b72. 2017-09-26 11:54:28 +00:00			`3. Once the project is open, click "File > Project Structure". Under "Project SDK:", set the project SDK by clicking "New...", clicking "JDK", and navigating to C:\\Program Files\\Java\\jdk1.8.0_XXX (where "XXX" is the latest minor version number). Click "OK".`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`4. Click "View > Tool Windows > Event Log", and click "Import Gradle project", then "OK". Wait, and click "OK" again when the "Gradle Project Data To Import" window appears`
			`5. Wait for indexing to finish (a progress bar will display at the bottom-right of the IntelliJ window until indexing is complete)`
			`6. At the top-right of the screen, to the left of the green "play" arrow, you should see a dropdown. In that dropdown, select "Run Example Cordapp - Kotlin" and click the green "play" arrow.`
			`7. Wait until the run windows displays the message "Webserver started up in XX.X sec"`
			`8. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/`

Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`.. _mac-label:`

Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`Mac`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`---`

			.. warning:: If you are using a Windows machine, please follow the :ref:`windows-label` instructions instead.
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
			`Java`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Open "System Preferences > Java"`
			`2. In the Java Control Panel, if an update is available, click "Update Now"`
			`3. In the "Software Update" window, click "Install Update". If required, enter your password and click "Install Helper" when prompted`
			`4. Wait for a pop-up window indicating that you have successfully installed the update, and click "Close"`
			5. Open a new terminal and type ``java -version`` to test that Java is installed correctly

			`IntelliJ`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Visit https://www.jetbrains.com/idea/download/download-thanks.html?platform=mac&code=IIC`
			`2. Download and run the executable to install IntelliJ Community Edition (use the default settings)`

			`Download a sample project`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Open a terminal`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			2. Clone the CorDapp example repo by running ``git clone https://github.com/corda/cordapp-example``
			3. Move into the cordapp-example folder by running ``cd cordapp-example``
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00
			`Run from the terminal`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^^^^^`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			1. From the cordapp-example folder, deploy the nodes by running ``./gradlew deployNodes``
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			2. Start the nodes by running ``kotlin-source/build/nodes/runnodes``. Do not click while 8 additional terminal windows start up.
			`3. Wait until all the terminal windows display either "Webserver started up in XX.X sec" or "Node for "NodeC" started up and registered in XX.XX sec"`
			`4. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/`

			`Run from IntelliJ`
Makes set-up instructions clearer. Addresses a zsh-related bug. 2017-09-04 16:07:40 +00:00			`^^^^^^^^^^^^^^^^^`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`1. Open IntelliJ Community Edition`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			`2. On the splash screen, click "Open" (do NOT click "Import Project") and select the cordapp-example folder`
Updates the Getting Set Up docs page with more detailed instructions. 2017-05-12 10:32:19 +00:00			`3. Once the project is open, click "File > Project Structure". Under "Project SDK:", set the project SDK by clicking "New...", clicking "JDK", and navigating to /Library/Java/JavaVirtualMachines/jdk1.8.0_XXX (where "XXX" is the latest minor version number). Click "OK".`
			`4. Click "View > Tool Windows > Event Log", and click "Import Gradle project", then "OK". Wait, and click "OK" again when the "Gradle Project Data To Import" window appears`
			`5. Wait for indexing to finish (a progress bar will display at the bottom-right of the IntelliJ window until indexing is complete)`
			`6. At the top-right of the screen, to the left of the green "play" arrow, you should see a dropdown. In that dropdown, select "Run Example Cordapp - Kotlin" and click the green "play" arrow.`
			`7. Wait until the run windows displays the message "Webserver started up in XX.X sec"`
			`8. Test the CorDapp is running correctly by visiting the front end at http://localhost:10007/web/example/`
Introduce documentation of the current prototype with a contract programming tutorial (incomplete), using the Sphinx docs engine. Actual generated HTML will follow in the next commit. 2015-11-25 13:27:07 +00:00
Cleaning up doc headers to be consistent wrt casing 2016-11-25 14:29:13 +00:00			`Corda source code`
First revision for 'getting set up' - docs not rebuilt as to keep changes visible 2016-11-14 18:12:39 +00:00			`-----------------`
Docs: mention what to do if IntelliJ complains about lack of a jdk 2015-12-08 15:47:45 +00:00
Provides clearer instructions on the 'Getting set up' page. Expands 'Troubleshooting' page. 2017-01-31 12:59:24 +00:00			`The Corda platform source code is available here:`
First revision for 'getting set up' - docs not rebuilt as to keep changes visible 2016-11-14 18:12:39 +00:00
Misc doc markup and TODO fixes. 2016-11-23 12:25:44 +00:00			`https://github.com/corda/corda.git`
Docs: mention what to do if IntelliJ complains about lack of a jdk 2015-12-08 15:47:45 +00:00
Updates template links to indicate both versions. 2017-07-28 08:13:53 +00:00			`A CorDapp template that you can use as the basis for your own CorDapps is available in both Java and Kotlin versions:`
Misc doc markup and TODO fixes. 2016-11-23 12:25:44 +00:00
Updates template links to indicate both versions. 2017-07-28 08:13:53 +00:00			`https://github.com/corda/cordapp-template-java.git`

			`https://github.com/corda/cordapp-template-kotlin.git`
Docs: mention what to do if IntelliJ complains about lack of a jdk 2015-12-08 15:47:45 +00:00
Reflects V1.0 changes on Master re: internal samples and identity sync flow API. 2017-10-25 08:29:32 +00:00			`And a list of simple sample CorDapps for you to explore basic concepts is available here:`
Provides clearer instructions on the 'Getting set up' page. Expands 'Troubleshooting' page. 2017-01-31 12:59:24 +00:00
Reflects V1.0 changes on Master re: internal samples and identity sync flow API. 2017-10-25 08:29:32 +00:00			`https://www.corda.net/samples/`
Changes docs to point to cordapp-tutorial instead of cordapp-template as appropriate. 2017-02-08 10:34:54 +00:00
			You can clone these repos to your local machine by running the command ``git clone [repo URL]``.

Provides clearer instructions on the 'Getting set up' page. Expands 'Troubleshooting' page. 2017-01-31 12:59:24 +00:00			`Next steps`
			`----------`
Moves code sections in tutorials to code files. 2017-10-01 22:33:15 +00:00			`The best way to check that everything is working fine is by taking a deeper look at the`
			:doc:`example CorDapp <tutorial-cordapp>`.
Docs: mention what to do if IntelliJ complains about lack of a jdk 2015-12-08 15:47:45 +00:00
Updates the example CorDapp page. 2017-07-21 11:33:31 +00:00			Next, you should read through :doc:`Corda Key Concepts <key-concepts>` to understand how Corda works.
Docs: mention what to do if IntelliJ complains about lack of a jdk 2015-12-08 15:47:45 +00:00
Reflects tutorial changes and CorDapp build docs changes from release-V1. 2017-11-16 15:31:52 +00:00			`By then, you'll be ready to start writing your own CorDapps. Learn how to do this in the`
			:doc:`Hello, World tutorial <hello-world-introduction>`. You may want to refer to the :doc:`API docs <api-index>`, the
Reflects V1.0 changes on Master re: internal samples and identity sync flow API. 2017-10-25 08:29:32 +00:00			:doc:`flow cookbook <flow-cookbook>` and the `samples <https://www.corda.net/samples/>`_ along the way.
Introduce documentation of the current prototype with a contract programming tutorial (incomplete), using the Sphinx docs engine. Actual generated HTML will follow in the next commit. 2015-11-25 13:27:07 +00:00
Docsite reorg ahead of beta launch. 2017-06-05 12:37:23 +00:00			If you encounter any issues, please see the :doc:`troubleshooting` page, or get in touch with us on the
Reflects tutorial changes and CorDapp build docs changes from release-V1. 2017-11-16 15:31:52 +00:00			`forums <https://discourse.corda.net/>`_ or via `slack <http://slack.corda.net/>`_.