diff --git a/constants.properties b/constants.properties index 611e68ef43..0c3a9c0d70 100644 --- a/constants.properties +++ b/constants.properties @@ -23,3 +23,5 @@ snakeYamlVersion=1.19 caffeineVersion=2.6.2 metricsVersion=3.2.5 metricsNewRelicVersion=1.1.1 +openSourceBranch=https://github.com/corda/corda/blob/release/4 +openSourceSamplesBranch=https://github.com/corda/samples/blob/release-V4 diff --git a/docs/source/api-testing.rst b/docs/source/api-testing.rst index 9d7aa36bdc..05338834db 100644 --- a/docs/source/api-testing.rst +++ b/docs/source/api-testing.rst @@ -161,8 +161,8 @@ Further examples * See the flow testing tutorial :doc:`here ` * See the oracle tutorial :doc:`here ` for information on testing ``@CordaService`` classes * Further examples are available in the Example CorDapp in - `Java `_ and - `Kotlin `_ + `Java <|os_samples_branch|/cordapp-example/workflows-java/src/test/java/com/example/test/flow/IOUFlowTests.java>`_ and + `Kotlin <|os_samples_branch|/cordapp-example/workflows-kotlin/src/test/kotlin/com/example/test/flow/IOUFlowTests.kt>`_ Contract testing ---------------- @@ -380,5 +380,5 @@ Further examples * See the flow testing tutorial :doc:`here ` * Further examples are available in the Example CorDapp in - `Java `_ and - `Kotlin `_ + `Java <|os_samples_branch|/cordapp-example/workflows-java/src/test/java/com/example/test/flow/IOUFlowTests.java>`_ and + `Kotlin <|os_samples_branch|/cordapp-example/workflows-kotlin/src/test/kotlin/com/example/test/flow/IOUFlowTests.kt>`_ diff --git a/docs/source/azure-vm.rst b/docs/source/azure-vm.rst index a5793d4872..0a00f46855 100644 --- a/docs/source/azure-vm.rst +++ b/docs/source/azure-vm.rst @@ -101,7 +101,7 @@ The nodes you will use to send and receive Yo messages require the Yo! CorDapp j Connect to one of your Corda nodes (make sure this is not the Notary node) using an SSH client of your choice (e.g. Putty) and log into the virtual machine using the public IP address and your SSH key or username / password combination you defined in Step 1 of the Azure build process. Type the following command: -Build the yo cordapp sample which you can find here: https://github.com/corda/samples/tree/release-V|platform_version|/yo-cordapp and install it in the cordapp directory. +Build the yo cordapp sample which you can find here: |os_samples_branch|/yo-cordapp and install it in the cordapp directory. Now restart Corda and the Corda webserver using the following commands or restart your Corda VM from the Azure portal: diff --git a/docs/source/conf.py b/docs/source/conf.py index fd5454059e..4408abbc28 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -23,7 +23,9 @@ corda_substitutions = { "|kotlin_version|" : constants_properties_dict["kotlinVersion"], "|gradle_plugins_version|" : constants_properties_dict["gradlePluginsVersion"], "|quasar_version|" : constants_properties_dict["quasarVersion"], - "|platform_version|" : constants_properties_dict["platformVersion"] + "|platform_version|" : constants_properties_dict["platformVersion"], + "|os_branch|" : constants_properties_dict["openSourceBranch"], + "|os_samples_branch|" : constants_properties_dict["openSourceSamplesBranch"] } def setup(app): diff --git a/docs/source/generating-a-node.rst b/docs/source/generating-a-node.rst index 53e115c7af..4e27326ea1 100644 --- a/docs/source/generating-a-node.rst +++ b/docs/source/generating-a-node.rst @@ -251,7 +251,7 @@ following line to each node's ``node.conf`` file: Where ``2222`` is the port you want to open to SSH into the shell. -Below you can find the example task from the `IRS Demo `_ included in the samples directory of main Corda GitHub repository: +Below you can find the example task from the `IRS Demo <|os_branch|/samples/irs-demo/cordapp/build.gradle#L111>`_ included in the samples directory of main Corda GitHub repository: .. sourcecode:: groovy diff --git a/docs/source/running-a-notary.rst b/docs/source/running-a-notary.rst index 28e725de2a..89ee965fe2 100644 --- a/docs/source/running-a-notary.rst +++ b/docs/source/running-a-notary.rst @@ -35,14 +35,14 @@ Crash fault-tolerant (experimental) =================================== Corda provides a prototype `Raft-based `_ highly available notary implementation. You can try it out on our -`notary demo `_ page. Note that it has known limitations +`notary demo <|os_branch|/samples/notary-demo>`_ page. Note that it has known limitations and is not recommended for production use. Byzantine fault-tolerant (experimental) ======================================= A prototype BFT notary implementation based on `BFT-Smart `_ is available. You can -try it out on our `notary demo `_ page. Note that it +try it out on our `notary demo <|os_branch|/samples/notary-demo>`_ page. Note that it is still experimental and there is active work ongoing for a production ready solution. Additionally, BFT-Smart requires Java serialization which is disabled by default in Corda due to security risks, and it will only work in dev mode where this can be customised.