Move upgrading docs out of experimental section (digital-asset#4889)

I’ve added a note that you have to target LF 1.8 for this to work. fixes digital-asset#4767 changelog_begin changelog_end
axman6 · Mar 9, 2020 · d4f96d9 · d4f96d9
1 parent 2b76d19
commit d4f96d9
Show file tree

Hide file tree

Showing 3 changed files with 6 additions and 2 deletions.
diff --git a/docs/configs/pdf/index.rst b/docs/configs/pdf/index.rst
@@ -37,6 +37,7 @@ Building applications
 
    app-dev/index
    daml-script/index
+   upgrade/index
    app-dev/bindings-java/index
    app-dev/bindings-scala/index
    app-dev/bindings-js
@@ -93,7 +94,6 @@ Experimental features
 
    experimental/warning
    daml-integration-kit/index
-   upgrade/index
    json-api/index
    triggers/index
    daml-repl/index

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -42,6 +42,7 @@ DAML SDK documentation
 
    app-dev/index
    DAML Script <daml-script/index>
+   upgrade/index
    app-dev/bindings-java/index
    app-dev/bindings-scala/index
    app-dev/bindings-js
@@ -97,7 +98,6 @@ DAML SDK documentation
    experimental/warning
    daml-integration-kit/index
    tools/ledger-api-test-tool/index
-   upgrade/index
    json-api/index
    DAML Triggers <triggers/index>
    DAML Repl <daml-repl/index>

diff --git a/docs/source/upgrade/index.rst b/docs/source/upgrade/index.rst
@@ -4,6 +4,10 @@
 Upgrading and extending DAML applications
 #########################################
 
+**Note:** Cross-SDK upgrades are only supported if you compile to
+DAML-LF 1.8 by specifying ``--target=1.8`` in the ``build-options``
+field in your ``daml.yaml``.
+
 In applications backed by a centralized database controlled by a
 single operator, it is possible to upgrade an application in a single
 step that migrates all existing data to a new data model.