From 80eb82acc22629d39a513ca2c21a14f4982ddce6 Mon Sep 17 00:00:00 2001
From: Nikolay Krasko <nikolay.krasko@jetbrains.com>
Date: Thu, 17 Nov 2022 11:28:28 +0100
Subject: [PATCH] Instructions for building 1.7.20 release

(cherry picked from commit 4c16d7597a845351edfed54f671a0a4c5612743e)
---
 docs/building/build-1.7.20.md | 59 +++++++++++++++++++++++++++++++++++
 docs/building/index.md        |  3 ++
 2 files changed, 62 insertions(+)
 create mode 100644 docs/building/build-1.7.20.md
 create mode 100644 docs/building/index.md

diff --git a/docs/building/build-1.7.20.md b/docs/building/build-1.7.20.md
new file mode 100644
index 0000000000000..977a18548ebac
--- /dev/null
+++ b/docs/building/build-1.7.20.md
@@ -0,0 +1,59 @@
+# Building 1.7.20
+
+This tutorial explains how to build release [1.7.20](https://github.com/JetBrains/kotlin/releases/tag/v1.7.20) locally.
+
+## Prerequisites
+You must have:
+* Linux or MacOS.
+* Docker installed.
+* 14 GB memory available and configured in Docker. 
+
+## Set environment variables
+
+The following environment variables must be set:
+
+```
+export DEPLOY_VERSION=1.7.20
+export BUILD_NUMBER=1.7.20-release-201
+export KOTLIN_NATIVE_VERSION=1.7.20
+export DOCKER_CONTAINER_URL=kotlin.registry.jetbrains.space/p/kotlin/containers/kotlin-build-env:v5
+```
+## Clone Kotlin repository
+
+In a new folder, clone the release tag from the Kotlin repository, and change directory to the build folder:
+
+```
+git clone --depth 1 --branch v$DEPLOY_VERSION https://github.com/JetBrains/kotlin.git kotlin-build-$DEPLOY_VERSION
+cd kotlin-build-$DEPLOY_VERSION
+```
+
+## Build and verify the compiler
+
+Download and save [scripts/build-kotlin-compiler.sh](https://github.com/JetBrains/kotlin/blob/1.7.20/scripts/build-kotlin-compiler.sh) to 
+the`scripts` folder in your repository, and then execute it in a docker container:
+
+```
+docker run --rm -it --name kotlin-build-$DEPLOY_VERSION \
+  --workdir="/repo" --volume="$(pwd):/repo" $DOCKER_CONTAINER_URL \
+  /bin/bash -c "./scripts/build-kotlin-compiler.sh $DEPLOY_VERSION $BUILD_NUMBER"
+```
+
+This generates a ZIP file: `dist/kotlin-compiler-1.7.20.zip`.
+
+Check that the SHA 256 checksum is the same as the ZIP file [published on GitHub](https://github.com/JetBrains/kotlin/releases/download/v1.7.20/kotlin-compiler-1.7.20.zip): 5e3c8d0f965410ff12e90d6f8dc5df2fc09fd595a684d514616851ce7e94ae7d
+
+## Build maven artifacts
+
+Download and save [scripts/build-kotlin-maven.sh](https://github.com/JetBrains/kotlin/blob/1.7.20/scripts/build-kotlin-maven.sh) to 
+the `scripts` folder in your repository, and then execute it in a docker container:
+
+```
+docker run --rm -it --name kotlin-build-$DEPLOY_VERSION \
+  --workdir="/repo" --volume="$(pwd):/repo" $DOCKER_CONTAINER_URL \
+  /bin/bash -c "./scripts/build-kotlin-maven.sh $DEPLOY_VERSION $BUILD_NUMBER $KOTLIN_NATIVE_VERSION"
+```
+
+This generates a ZIP file: `build/repo-reproducible/reproducible-maven-1.7.20.zip`.
+
+**Note:** Instructions for checking reproducibility will be covered in the upcoming release. There are already many JAR files on Maven
+central that are reproducible with this tutorial.
diff --git a/docs/building/index.md b/docs/building/index.md
new file mode 100644
index 0000000000000..1c217688b7699
--- /dev/null
+++ b/docs/building/index.md
@@ -0,0 +1,3 @@
+# Kotlin builds
+
+* [1.7.20 Release](build-1.7.20.md)
\ No newline at end of file