diff --git a/docs/source/getting-set-up.rst b/docs/source/getting-set-up.rst index 485b15c286..615849d5b6 100644 --- a/docs/source/getting-set-up.rst +++ b/docs/source/getting-set-up.rst @@ -26,7 +26,7 @@ Please note: `getting started guide `_, and a series of `Kotlin Koans `_. -* IntelliJ IDEA is recommended due to the strength of its Kotlin integration. +* 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. @@ -73,39 +73,6 @@ IntelliJ 2. Download and run the executable to install IntelliJ Community Edition (use the default settings) 3. Ensure the Kotlin plugin in Intellij is updated to version |kotlin_version| -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:10009/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``, then ``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. Again under ``File`` then ``Project Structure``, select ``Modules``. Click ``+``, then ``Import Module``, then select - the ``cordapp-example`` folder and click ``Open``. Choose to ``Import module from external model``, select - ``Gradle``, click ``Next`` then ``Finish`` (leaving the defaults) and ``OK`` -5. Wait for the 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:10009/web/example/ - .. _mac-label: Mac @@ -128,48 +95,16 @@ IntelliJ 2. Download and run the executable to install IntelliJ Community Edition (use the default settings) 3. Ensure the Kotlin plugin in Intellij is updated to version |kotlin_version| -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 7 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:10009/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``, then ``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. Again under ``File`` then ``Project Structure``, select ``Modules``. Click ``+``, then ``Import Module``, then select - the ``cordapp-example`` folder and click ``Open``. Choose to ``Import module from external model``, select - ``Gradle``, click ``Next`` then ``Finish`` (leaving the defaults) and ``OK`` -5. Wait for the 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:10009/web/example/ - Next steps ---------- -First, explore the example CorDapp you just ran :doc:`here `. +First, run the :doc:`example CorDapp `. -Next, read through :doc:`Corda Key Concepts ` to understand how Corda works. +Next, read through the :doc:`Corda 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 `. You may want to refer to the API documentation, the -:doc:`flow cookbook ` and the `samples `_ along the way. +:doc:`Hello, World tutorial `. You may want to refer to the +:doc:`API documentation `, the :doc:`flow cookbook ` and the +`samples `_ along the way. -If you encounter any issues, please see the :doc:`troubleshooting` page, or ask on -`Stack Overflow `_ or via `our Slack channels `_. +If you encounter any issues, please ask on `Stack Overflow `_ or via +`our Slack channels `_.