From 8cf979b5aee0a95eb56218a2d0401697eb654d73 Mon Sep 17 00:00:00 2001
From: berezinant <berezinant@gmail.com>
Date: Thu, 13 Feb 2025 12:35:54 +0100
Subject: [PATCH 1/6] update templates for Dokka 2.0.0

---
 dokka-templates/base.ftl                      | 18 ++++++-
 dokka-templates/includes/header.ftl           | 49 ++++++++++---------
 .../includes/source_set_selector.ftl          | 34 +++++++++++--
 3 files changed, 75 insertions(+), 26 deletions(-)

diff --git a/dokka-templates/base.ftl b/dokka-templates/base.ftl
index 0674e1657fe..489b9209e05 100644
--- a/dokka-templates/base.ftl
+++ b/dokka-templates/base.ftl
@@ -36,7 +36,23 @@
     <@header.display/>
     <div id="container" data-test="content">
         <div class="sidebar" id="leftColumn">
-            <div class="sidebar--inner" id="sideMenu"></div>
+            <div class="dropdown theme-dark_mobile" data-role="dropdown" id="toc-dropdown">
+                <ul role="listbox" id="toc-listbox" class="dropdown--list dropdown--list_toc-list"
+                    data-role="dropdown-listbox">
+                    <div class="dropdown--header">
+                            <span>
+                                <@template_cmd name="projectName">
+                                    ${projectName}
+                                </@template_cmd>
+                            </span>
+                        <button class="button" data-role="dropdown-toggle" aria-label="Close table of contents">
+                            <i class="ui-kit-icon ui-kit-icon_cross"></i>
+                        </button>
+                    </div>
+                    <div class="sidebar--inner" id="sideMenu"></div>
+                </ul>
+                <div class="dropdown--overlay"></div>
+            </div>
         </div>
         <div id="main">
             <@content/>
diff --git a/dokka-templates/includes/header.ftl b/dokka-templates/includes/header.ftl
index 91b5a1a1107..5a96fb8e46d 100644
--- a/dokka-templates/includes/header.ftl
+++ b/dokka-templates/includes/header.ftl
@@ -1,28 +1,33 @@
 <#import "source_set_selector.ftl" as source_set_selector>
 <#macro display>
-    <nav class="navigation" id="navigation-wrapper">
-        <div class="navigation--inner">
-            <div class="navigation-title">
-                <button class="menu-toggle" id="menu-toggle" type="button">toggle menu</button>
-                <div class="library-name">
-                    <@template_cmd name="pathToRoot">
-                        <a class="library-name--link" href="${pathToRoot}index.html">
-                            <@template_cmd name="projectName">
-                                ${projectName}
-                            </@template_cmd>
-                        </a>
-                    </@template_cmd>
-                </div>
-                <div class="library-version">
-                    <#-- This can be handled by the versioning plugin -->
-                    <@version/>
-                </div>
-            </div>
-            <@source_set_selector.display/>
+    <nav class="navigation theme-dark" id="navigation-wrapper">
+        <@template_cmd name="pathToRoot">
+            <a class="library-name--link" href="${pathToRoot}index.html">
+                <@template_cmd name="projectName">
+                    ${projectName}
+                </@template_cmd>
+            </a>
+        </@template_cmd>
+        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle"
+                type="button">Toggle table of contents
+        </button>
+        <div class="navigation-controls--break ui-kit_mobile-only"></div>
+        <div class="library-version" id="library-version">
+            <#-- This can be handled by the versioning plugin -->
+            <@version/>
         </div>
         <div class="navigation-controls">
-            <button class="navigation-controls--btn navigation-controls--theme" id="theme-toggle-button" type="button">switch theme</button>
-            <div class="navigation-controls--btn navigation-controls--search" id="searchBar" role="button">search in API</div>
+            <@source_set_selector.display/>
+            <#if homepageLink?has_content>
+                <a class="navigation-controls--btn navigation-controls--btn_homepage" id="homepage-link"
+                   href="${homepageLink}"></a>
+            </#if>
+            <button class="navigation-controls--btn navigation-controls--btn_theme" id="theme-toggle-button"
+                    type="button">Switch theme
+            </button>
+            <div class="navigation-controls--btn navigation-controls--btn_search" id="searchBar" role="button">Search in
+                API
+            </div>
         </div>
     </nav>
-</#macro>
\ No newline at end of file
+</#macro>
diff --git a/dokka-templates/includes/source_set_selector.ftl b/dokka-templates/includes/source_set_selector.ftl
index 40329528ef0..644983ba567 100644
--- a/dokka-templates/includes/source_set_selector.ftl
+++ b/dokka-templates/includes/source_set_selector.ftl
@@ -1,9 +1,37 @@
 <#macro display>
     <#if sourceSets?has_content>
-        <div class="filter-section" id="filter-section">
+        <div class="filter-section filter-section_loading" id="filter-section">
             <#list sourceSets as ss>
-                <button class="platform-tag platform-selector ${ss.platform}-like" data-active="" data-filter="${ss.filter}">${ss.name}</button>
+                <button class="platform-tag platform-selector ${ss.platform}-like" data-active=""
+                        data-filter="${ss.filter}">${ss.name}</button>
             </#list>
+            <div class="dropdown filter-section--dropdown" data-role="dropdown" id="filter-section-dropdown">
+                <button class="button button_dropdown filter-section--dropdown-toggle" role="combobox"
+                        data-role="dropdown-toggle"
+                        aria-controls="platform-tags-listbox"
+                        aria-haspopup="listbox"
+                        aria-expanded="false"
+                        aria-label="Toggle source sets"
+                ></button>
+                <ul role="listbox" id="platform-tags-listbox" class="dropdown--list" data-role="dropdown-listbox">
+                    <div class="dropdown--header"><span>Platform filter</span>
+                        <button class="button" data-role="dropdown-toggle" aria-label="Close platform filter">
+                            <i class="ui-kit-icon ui-kit-icon_cross"></i>
+                        </button>
+                    </div>
+                    <#list sourceSets as ss>
+                        <li role="option" class="dropdown--option platform-selector-option ${ss.platform}-like" tabindex="0">
+                            <label class="checkbox">
+                                <input type="checkbox" class="checkbox--input" id="${ss.filter}"
+                                       data-filter="${ss.filter}"/>
+                                <span class="checkbox--icon"></span>
+                                ${ss.name}
+                            </label>
+                        </li>
+                    </#list>
+                </ul>
+                <div class="dropdown--overlay"></div>
+            </div>
         </div>
     </#if>
-</#macro>
\ No newline at end of file
+</#macro>

From a3a01f2612fbc1128232b7f48be5b561f3b943e0 Mon Sep 17 00:00:00 2001
From: zoobestik <kb.chernenko@gmail.com>
Date: Fri, 14 Feb 2025 14:42:33 +0100
Subject: [PATCH 2/6] refactor(builds): update release tag variables to use
 labels dynamically

---
 .teamcity/BuildParams.kt                         | 16 ++++++++++++----
 .../KotlinxCoroutinesBuildApiReference.kt        |  4 ++--
 .../datetime/KotlinxDatetimeBuildApiReference.kt |  4 ++--
 .../KotlinxSerializationBuildApiReference.kt     |  4 ++--
 .../apiReferences/vcsRoots/KotlinxCoroutines.kt  |  3 ++-
 .../apiReferences/vcsRoots/KotlinxDatetime.kt    |  3 ++-
 .../vcsRoots/KotlinxSerialization.kt             |  3 ++-
 7 files changed, 24 insertions(+), 13 deletions(-)

diff --git a/.teamcity/BuildParams.kt b/.teamcity/BuildParams.kt
index be440be281e..522201c297b 100644
--- a/.teamcity/BuildParams.kt
+++ b/.teamcity/BuildParams.kt
@@ -1,19 +1,27 @@
 object BuildParams {
   const val DOKKA_TEMPLATES_VERSION = "1.9.10"
 
-  const val KOTLINX_COROUTINES_RELEASE_TAG = "1.10.1"
+  const val KOTLINX_COROUTINES_RELEASE_LABEL = "1.10.1"
+  const val KOTLINX_COROUTINES_RELEASE_TAG = "master"
   const val KOTLINX_COROUTINES_ID = "kotlinx.coroutines"
-  const val KOTLINX_SERIALIZATION_RELEASE_TAG = "v1.8.0"
+
+  const val KOTLINX_SERIALIZATION_RELEASE_LABEL = "v1.8.0"
+  const val KOTLINX_SERIALIZATION_RELEASE_TAG = "master"
   const val KOTLINX_SERIALIZATION_ID = "kotlinx.serialization"
-  const val KOTLINX_DATETIME_RELEASE_TAG = "v0.6.2"
+
+  const val KOTLINX_DATETIME_RELEASE_LABEL = "v0.6.2"
+  const val KOTLINX_DATETIME_RELEASE_TAG = "latest-release"
   const val KOTLINX_DATETIME_ID = "kotlinx-datetime"
+
   const val KOTLINX_IO_RELEASE_TAG = "0.6.0"
   const val KOTLINX_IO_ID = "kotlinx-io"
+
   const val KOTLINX_METADATA_ID = "kotlinx-metadata-jvm"
   const val KOTLIN_CORE_API_BUILD_ID = "Kotlin_KotlinRelease_210_LibraryReferenceLatestDocs"
   const val KOTLIN_RELEASE_TAG = "v2.1.0"
-  const val KGP_ID = "kotlin-gradle-plugin"
+
   val KGP_RELEASE_TAG = if (KOTLIN_RELEASE_TAG >= "v2.1.0") KOTLIN_RELEASE_TAG else "2.1.0"
+  const val KGP_ID = "kotlin-gradle-plugin"
 
   const val SEARCH_APP_ID = "7961PKYRXV"
   const val SEARCH_INDEX_NAME = "prod_KOTLINLANG_WEBHELP"
diff --git a/.teamcity/builds/apiReferences/kotlinx/coroutines/KotlinxCoroutinesBuildApiReference.kt b/.teamcity/builds/apiReferences/kotlinx/coroutines/KotlinxCoroutinesBuildApiReference.kt
index 55e078191cc..6486c151086 100644
--- a/.teamcity/builds/apiReferences/kotlinx/coroutines/KotlinxCoroutinesBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kotlinx/coroutines/KotlinxCoroutinesBuildApiReference.kt
@@ -1,13 +1,13 @@
 package builds.apiReferences.kotlinx.coroutines
 
 import BuildParams.KOTLINX_COROUTINES_ID
-import BuildParams.KOTLINX_COROUTINES_RELEASE_TAG
+import BuildParams.KOTLINX_COROUTINES_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.vcsRoots.KotlinxCoroutines
 
 object KotlinxCoroutinesBuildApiReference : BuildApiPages(
-    apiId = KOTLINX_COROUTINES_ID, releaseTag = KOTLINX_COROUTINES_RELEASE_TAG, init = {
+    apiId = KOTLINX_COROUTINES_ID, releaseTag = KOTLINX_COROUTINES_RELEASE_LABEL, init = {
         vcs {
             root(KotlinxCoroutines)
         }
diff --git a/.teamcity/builds/apiReferences/kotlinx/datetime/KotlinxDatetimeBuildApiReference.kt b/.teamcity/builds/apiReferences/kotlinx/datetime/KotlinxDatetimeBuildApiReference.kt
index b96340453fe..2e78926daa7 100644
--- a/.teamcity/builds/apiReferences/kotlinx/datetime/KotlinxDatetimeBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kotlinx/datetime/KotlinxDatetimeBuildApiReference.kt
@@ -1,7 +1,7 @@
 package builds.apiReferences.kotlinx.datetime
 
 import BuildParams.KOTLINX_DATETIME_ID
-import BuildParams.KOTLINX_DATETIME_RELEASE_TAG
+import BuildParams.KOTLINX_DATETIME_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.scriptBuildHtml
@@ -12,7 +12,7 @@ private const val DOKKA_HTML_RESULT = "core/build/dokka/html"
 
 object KotlinxDatetimeBuildApiReference : BuildApiPages(
     apiId = KOTLINX_DATETIME_ID,
-    releaseTag = KOTLINX_DATETIME_RELEASE_TAG,
+    releaseTag = KOTLINX_DATETIME_RELEASE_LABEL,
     pagesRoot = DOKKA_HTML_RESULT,
     stepDropSnapshot = {
         scriptDropSnapshot {
diff --git a/.teamcity/builds/apiReferences/kotlinx/serialization/KotlinxSerializationBuildApiReference.kt b/.teamcity/builds/apiReferences/kotlinx/serialization/KotlinxSerializationBuildApiReference.kt
index dc16f6c8fdc..941b207a772 100644
--- a/.teamcity/builds/apiReferences/kotlinx/serialization/KotlinxSerializationBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kotlinx/serialization/KotlinxSerializationBuildApiReference.kt
@@ -1,13 +1,13 @@
 package builds.apiReferences.kotlinx.serialization
 
 import BuildParams.KOTLINX_SERIALIZATION_ID
-import BuildParams.KOTLINX_SERIALIZATION_RELEASE_TAG
+import BuildParams.KOTLINX_SERIALIZATION_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.vcsRoots.KotlinxSerialization
 
 object KotlinxSerializationBuildApiReference : BuildApiPages(
-    apiId = KOTLINX_SERIALIZATION_ID, releaseTag = KOTLINX_SERIALIZATION_RELEASE_TAG, init = {
+    apiId = KOTLINX_SERIALIZATION_ID, releaseTag = KOTLINX_SERIALIZATION_RELEASE_LABEL, init = {
         vcs {
             root(KotlinxSerialization)
         }
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
index fd1bf9e9283..8bdf2de54f8 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
@@ -1,11 +1,12 @@
 package builds.apiReferences.vcsRoots
 
+import BuildParams.KOTLINX_COROUTINES_RELEASE_TAG
 import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 
 object KotlinxCoroutines : GitVcsRoot({
   name = "kotlinx.coroutines vcs root"
   url = "git@github.com:Kotlin/kotlinx.coroutines.git"
-  branch = "refs/heads/master"
+  branch = "refs/heads/$KOTLINX_COROUTINES_RELEASE_TAG"
   branchSpec = """
         +:refs/heads/(*)
     """.trimIndent()
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
index 2faf3b6c4b8..3a7d179a660 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
@@ -1,11 +1,12 @@
 package builds.apiReferences.vcsRoots
 
+import BuildParams.KOTLINX_DATETIME_RELEASE_TAG
 import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 
 object KotlinxDatetime: GitVcsRoot({
   name = "kotlinx-datetime vcs root"
   url = "git@github.com:Kotlin/kotlinx-datetime.git"
-  branch = "refs/heads/latest-release"
+  branch = "refs/heads/$KOTLINX_DATETIME_RELEASE_TAG"
   branchSpec = """
         +:refs/heads/(*)
         +:refs/tags/(*)
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
index ec2cde1bfc7..e7cbc648307 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
@@ -1,11 +1,12 @@
 package builds.apiReferences.vcsRoots
 
+import BuildParams.KOTLINX_SERIALIZATION_RELEASE_TAG
 import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 
 object KotlinxSerialization: GitVcsRoot({
   name = "kotlinx.serialization vcs root"
   url = "git@github.com:Kotlin/kotlinx.serialization.git"
-  branch = "refs/heads/master"
+  branch = "refs/heads/$KOTLINX_SERIALIZATION_RELEASE_TAG"
   branchSpec = """
         +:refs/heads/(*)
     """.trimIndent()

From e6943d839bb9caece2dd4f336a6624d14dbbdfc2 Mon Sep 17 00:00:00 2001
From: zoobestik <kb.chernenko@gmail.com>
Date: Fri, 14 Feb 2025 15:52:25 +0100
Subject: [PATCH 3/6] refactor(build-config): streamline release tag usage
 across build pipelines - Replace hardcoded tag prefixes with dynamic release
 labels - Update vcs branch specs to include both heads and tags for all
 configurations - Align naming consistency for release properties

---
 .teamcity/BuildParams.kt                      | 19 +++++++++++--------
 .../KotlinGradlePluginBuildApiReference.kt    |  7 +++----
 .../kotlinx/io/KotlinxIOBuildApiReference.kt  |  4 ++--
 .../KotlinxMetadataJvmBuildApiReference.kt    |  6 +++---
 .../builds/apiReferences/vcsRoots/Kotlin.kt   |  2 +-
 .../apiReferences/vcsRoots/KotlinKGP.kt       |  2 +-
 .../vcsRoots/KotlinxCoroutines.kt             |  7 ++++---
 .../apiReferences/vcsRoots/KotlinxDatetime.kt |  8 ++++----
 .../apiReferences/vcsRoots/KotlinxIO.kt       |  2 +-
 .../vcsRoots/KotlinxSerialization.kt          |  7 ++++---
 .teamcity/vcsRoots/KotlinLangOrg.kt           |  7 +++++--
 11 files changed, 39 insertions(+), 32 deletions(-)

diff --git a/.teamcity/BuildParams.kt b/.teamcity/BuildParams.kt
index 522201c297b..de3291691a5 100644
--- a/.teamcity/BuildParams.kt
+++ b/.teamcity/BuildParams.kt
@@ -1,26 +1,29 @@
 object BuildParams {
-  const val DOKKA_TEMPLATES_VERSION = "1.9.10"
+  const val DOKKA_TEMPLATES_VERSION = "2.0.0"
 
   const val KOTLINX_COROUTINES_RELEASE_LABEL = "1.10.1"
-  const val KOTLINX_COROUTINES_RELEASE_TAG = "master"
+  const val KOTLINX_COROUTINES_RELEASE_TAG = "whyoleg/dokka2-sync" // master``
   const val KOTLINX_COROUTINES_ID = "kotlinx.coroutines"
 
   const val KOTLINX_SERIALIZATION_RELEASE_LABEL = "v1.8.0"
-  const val KOTLINX_SERIALIZATION_RELEASE_TAG = "master"
+  const val KOTLINX_SERIALIZATION_RELEASE_TAG = "whyoleg/dokka2-sync" // master
   const val KOTLINX_SERIALIZATION_ID = "kotlinx.serialization"
 
   const val KOTLINX_DATETIME_RELEASE_LABEL = "v0.6.2"
-  const val KOTLINX_DATETIME_RELEASE_TAG = "latest-release"
+  const val KOTLINX_DATETIME_RELEASE_TAG = "whyoleg/dokka2-sync" // latest-release
   const val KOTLINX_DATETIME_ID = "kotlinx-datetime"
 
-  const val KOTLINX_IO_RELEASE_TAG = "0.6.0"
+  const val KOTLINX_IO_RELEASE_LABEL = "0.6.0" // KOTLINX_IO_RELEASE_TAG
+  const val KOTLINX_IO_RELEASE_TAG = "whyoleg/dokka2-sync" // 0.6.0
   const val KOTLINX_IO_ID = "kotlinx-io"
 
-  const val KOTLINX_METADATA_ID = "kotlinx-metadata-jvm"
+  const val KOTLIN_RELEASE_LABEL = "2.1.0"
+  const val KOTLIN_RELEASE_TAG = "whyoleg/dokka2-sync-stdlib"
   const val KOTLIN_CORE_API_BUILD_ID = "Kotlin_KotlinRelease_210_LibraryReferenceLatestDocs"
-  const val KOTLIN_RELEASE_TAG = "v2.1.0"
+  const val KOTLINX_METADATA_ID = "kotlinx-metadata-jvm"
 
-  val KGP_RELEASE_TAG = if (KOTLIN_RELEASE_TAG >= "v2.1.0") KOTLIN_RELEASE_TAG else "2.1.0"
+  const val KGP_RELEASE_LABEL = KOTLIN_RELEASE_LABEL
+  const val KGP_RELEASE_TAG = "whyoleg/dokka2-sync"
   const val KGP_ID = "kotlin-gradle-plugin"
 
   const val SEARCH_APP_ID = "7961PKYRXV"
diff --git a/.teamcity/builds/apiReferences/kgp/KotlinGradlePluginBuildApiReference.kt b/.teamcity/builds/apiReferences/kgp/KotlinGradlePluginBuildApiReference.kt
index 84e317a40ee..9ea7326197b 100644
--- a/.teamcity/builds/apiReferences/kgp/KotlinGradlePluginBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kgp/KotlinGradlePluginBuildApiReference.kt
@@ -1,8 +1,7 @@
 package builds.apiReferences.kgp
 
 import BuildParams.KGP_ID
-import BuildParams.KGP_RELEASE_TAG
-import BuildParams.KOTLIN_RELEASE_TAG
+import BuildParams.KGP_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.scriptBuildHtml
@@ -13,7 +12,7 @@ private const val KGP_API_OUTPUT_DIR = "libraries/tools/gradle/documentation/bui
 private const val KGP_API_TEMPLATES_DIR = "build/api-reference/templates"
 
 object KotlinGradlePluginBuildApiReference : BuildApiPages(
-    apiId = KGP_ID, releaseTag = KGP_RELEASE_TAG,
+    apiId = KGP_ID, releaseTag = KGP_RELEASE_LABEL,
     pagesRoot = KGP_API_OUTPUT_DIR,
     vcsDefaultTrigger = { enabled = false },
     stepDropSnapshot = { null },
@@ -27,7 +26,7 @@ object KotlinGradlePluginBuildApiReference : BuildApiPages(
                 #!/bin/bash
                  set -e -u
                 ./gradlew :gradle:documentation:dokkaKotlinlangDocumentation -PdeployVersion=${
-                KGP_RELEASE_TAG.removePrefix("v")
+                KGP_RELEASE_LABEL
             } --no-daemon --no-configuration-cache
             """.trimIndent()
         }
diff --git a/.teamcity/builds/apiReferences/kotlinx/io/KotlinxIOBuildApiReference.kt b/.teamcity/builds/apiReferences/kotlinx/io/KotlinxIOBuildApiReference.kt
index 3f2ea7f15c6..5e16539db2a 100644
--- a/.teamcity/builds/apiReferences/kotlinx/io/KotlinxIOBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kotlinx/io/KotlinxIOBuildApiReference.kt
@@ -1,7 +1,7 @@
 package builds.apiReferences.kotlinx.io
 
 import BuildParams.KOTLINX_IO_ID
-import BuildParams.KOTLINX_IO_RELEASE_TAG
+import BuildParams.KOTLINX_IO_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.scriptBuildHtml
@@ -10,7 +10,7 @@ import jetbrains.buildServer.configs.kotlin.buildSteps.ScriptBuildStep
 
 object KotlinxIOBuildApiReference : BuildApiPages(
     apiId = KOTLINX_IO_ID,
-    releaseTag = KOTLINX_IO_RELEASE_TAG.removePrefix("v"),
+    releaseTag = KOTLINX_IO_RELEASE_LABEL.removePrefix("v"),
     stepDokkaVersionSync = {
         // TODO readme, and disable this step for other libs too
         null
diff --git a/.teamcity/builds/apiReferences/kotlinx/metadataJvm/KotlinxMetadataJvmBuildApiReference.kt b/.teamcity/builds/apiReferences/kotlinx/metadataJvm/KotlinxMetadataJvmBuildApiReference.kt
index 1476c7130f2..eb78f0d8ba9 100644
--- a/.teamcity/builds/apiReferences/kotlinx/metadataJvm/KotlinxMetadataJvmBuildApiReference.kt
+++ b/.teamcity/builds/apiReferences/kotlinx/metadataJvm/KotlinxMetadataJvmBuildApiReference.kt
@@ -1,7 +1,7 @@
 package builds.apiReferences.kotlinx.metadataJvm
 
 import BuildParams.KOTLINX_METADATA_ID
-import BuildParams.KOTLIN_RELEASE_TAG
+import BuildParams.KOTLIN_RELEASE_LABEL
 import builds.apiReferences.BuildApiPages
 import builds.apiReferences.dependsOnDokkaTemplate
 import builds.apiReferences.scriptBuildHtml
@@ -12,7 +12,7 @@ private const val LIB_DIR = "libraries/kotlinx-metadata/jvm"
 
 object KotlinxMetadataJvmBuildApiReference : BuildApiPages(
     apiId = KOTLINX_METADATA_ID,
-    releaseTag = KOTLIN_RELEASE_TAG,
+    releaseTag = KOTLIN_RELEASE_LABEL,
     pagesRoot = "$LIB_DIR/build/dokka",
     vcsDefaultTrigger = { enabled = false },
     stepDropSnapshot = { null },
@@ -26,7 +26,7 @@ object KotlinxMetadataJvmBuildApiReference : BuildApiPages(
                 scriptContent = """
                     #!/bin/bash
                      set -e -u
-                    ./gradlew :kotlin-metadata-jvm:dokkaHtml -PdeployVersion=${KOTLIN_RELEASE_TAG.removePrefix("v")} --no-daemon --no-configuration-cache
+                    ./gradlew :kotlin-metadata-jvm:dokkaHtml -PdeployVersion=${KOTLIN_RELEASE_LABEL} --no-daemon --no-configuration-cache
                 """.trimIndent()
             }
         }
diff --git a/.teamcity/builds/apiReferences/vcsRoots/Kotlin.kt b/.teamcity/builds/apiReferences/vcsRoots/Kotlin.kt
index 5705db41aca..52679e65126 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/Kotlin.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/Kotlin.kt
@@ -6,7 +6,7 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object Kotlin : GitVcsRoot({
   name = "kotlin metadata vcs root"
   url = "git@github.com:JetBrains/kotlin.git"
-  branch = "refs/tags/$KOTLIN_RELEASE_TAG"
+  branch = KOTLIN_RELEASE_TAG
   branchSpec = """
     +:refs/heads/(*)
     +:refs/tags/(*)
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinKGP.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinKGP.kt
index 2b205bc3663..b916c2c72de 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinKGP.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinKGP.kt
@@ -6,7 +6,7 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinKGP : GitVcsRoot({
     name = "kotlin Gradle Plugin vcs root"
     url = "git@github.com:JetBrains/kotlin.git"
-    branch = "refs/${if (KGP_RELEASE_TAG.startsWith("v")) "tags" else "heads"}/$KGP_RELEASE_TAG"
+    branch = KGP_RELEASE_TAG
     branchSpec = """
         +:refs/heads/(*)
         +:refs/tags/(*)
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
index 8bdf2de54f8..89cbefe354e 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxCoroutines.kt
@@ -6,10 +6,11 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinxCoroutines : GitVcsRoot({
   name = "kotlinx.coroutines vcs root"
   url = "git@github.com:Kotlin/kotlinx.coroutines.git"
-  branch = "refs/heads/$KOTLINX_COROUTINES_RELEASE_TAG"
+  branch = KOTLINX_COROUTINES_RELEASE_TAG
   branchSpec = """
-        +:refs/heads/(*)
-    """.trimIndent()
+    +:refs/heads/(*)
+    +:refs/tags/(*)
+  """.trimIndent()
   useTagsAsBranches = true
   checkoutPolicy = AgentCheckoutPolicy.USE_MIRRORS
   authMethod = uploadedKey {
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
index 3a7d179a660..d30dd702160 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxDatetime.kt
@@ -6,11 +6,11 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinxDatetime: GitVcsRoot({
   name = "kotlinx-datetime vcs root"
   url = "git@github.com:Kotlin/kotlinx-datetime.git"
-  branch = "refs/heads/$KOTLINX_DATETIME_RELEASE_TAG"
+  branch = KOTLINX_DATETIME_RELEASE_TAG
   branchSpec = """
-        +:refs/heads/(*)
-        +:refs/tags/(*)
-    """.trimIndent()
+    +:refs/heads/(*)
+    +:refs/tags/(*)
+  """.trimIndent()
   useTagsAsBranches = true
   authMethod = uploadedKey {
     uploadedKey = "teamcity"
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxIO.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxIO.kt
index 1d0b5f93a5f..20db3f1835b 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxIO.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxIO.kt
@@ -6,7 +6,7 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinxIO : GitVcsRoot({
   name = "kotlinx-io vcs root"
   url = "git@github.com:Kotlin/kotlinx-io.git"
-  branch = "refs/tags/$KOTLINX_IO_RELEASE_TAG"
+  branch = KOTLINX_IO_RELEASE_TAG
   branchSpec = """
     +:refs/heads/(*)
     +:refs/tags/(*)
diff --git a/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt b/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
index e7cbc648307..520051f82e3 100644
--- a/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
+++ b/.teamcity/builds/apiReferences/vcsRoots/KotlinxSerialization.kt
@@ -6,10 +6,11 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinxSerialization: GitVcsRoot({
   name = "kotlinx.serialization vcs root"
   url = "git@github.com:Kotlin/kotlinx.serialization.git"
-  branch = "refs/heads/$KOTLINX_SERIALIZATION_RELEASE_TAG"
+  branch = KOTLINX_SERIALIZATION_RELEASE_TAG
   branchSpec = """
-        +:refs/heads/(*)
-    """.trimIndent()
+    +:refs/heads/(*)
+    +:refs/tags/(*)
+  """.trimIndent()
   useTagsAsBranches = true
   authMethod = uploadedKey {
     uploadedKey = "teamcity"
diff --git a/.teamcity/vcsRoots/KotlinLangOrg.kt b/.teamcity/vcsRoots/KotlinLangOrg.kt
index c4b93ad830d..7e26f7d5b44 100644
--- a/.teamcity/vcsRoots/KotlinLangOrg.kt
+++ b/.teamcity/vcsRoots/KotlinLangOrg.kt
@@ -5,8 +5,11 @@ import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
 object KotlinLangOrg: GitVcsRoot({
   name = "kotlinlang.org VCS root"
   url = "ssh://git@github.com/JetBrains/kotlin-web-site"
-  branch = "refs/heads/master"
-  branchSpec = "+:refs/heads/(*)"
+  branch = "master"
+  branchSpec = """
+    +:refs/heads/(*)
+    +:refs/tags/(*)
+  """.trimIndent()
   authMethod = uploadedKey {
     uploadedKey = "default teamcity key"
   }

From 988ea05a2fc7738e6d4cef347b3680dfa7314626 Mon Sep 17 00:00:00 2001
From: berezinant <berezinant@gmail.com>
Date: Fri, 21 Feb 2025 08:17:13 +0100
Subject: [PATCH 4/6] fix: adjusted dokka template styles

---
 .../js/page/dokka-template/control-pane.scss  | 37 ++++---------------
 static/js/page/dokka-template/layout.scss     |  6 ---
 2 files changed, 7 insertions(+), 36 deletions(-)

diff --git a/static/js/page/dokka-template/control-pane.scss b/static/js/page/dokka-template/control-pane.scss
index 493d32eb77f..4bd8ac35ed1 100644
--- a/static/js/page/dokka-template/control-pane.scss
+++ b/static/js/page/dokka-template/control-pane.scss
@@ -4,39 +4,14 @@
     position: relative;
     z-index: 10;
 
-    @media (min-width: 760px) {
-      padding-left: 32px;
-      padding-right: 32px;
-    }
-
     @media (min-width: 940px) {
       min-height: 70px; /* KTL-1147 */
       box-sizing: border-box;
     }
-
-    &, #pages-search {
-      background: none #1b1b1b;
-    }
-  }
-
-  .navigation > .library-name {
-    margin-right: 0;
-  }
-
-  .library-name > .library-name--link {
-    margin-left: 0;
-
-    &::before {
-      display: none;
-    }
   }
 
-  @media (min-width: 940px) {
-    .filter-section .platform-tag {
-      font-size: 16px;
-      border-radius: 24px;
-      padding: 8px 24px;
-    }
+  .library-name--link::before {
+    display: none;
   }
 
   #searchBar {
@@ -45,13 +20,15 @@
     }
   }
 
-  .navigation-controls--theme {
+  .navigation-controls--btn_theme {
     /* this is the last icon in pane have much more spacing for click then
        the last icon in global header. It did for same right border for both panes */
-    margin-right: -8px;
+    @media(min-width: 760px) {
+      margin-right: -8px;
+    }
   }
 }
 
 .core-api #searchBar {
-  display: none!important;
+  display: none !important;
 }
diff --git a/static/js/page/dokka-template/layout.scss b/static/js/page/dokka-template/layout.scss
index 91f746ccc3f..32d13bf2631 100644
--- a/static/js/page/dokka-template/layout.scss
+++ b/static/js/page/dokka-template/layout.scss
@@ -9,12 +9,6 @@
 
   /* / Fix global dokka styles */
 
-  #sideMenu {
-    @media (min-width: 760px) {
-      padding-left: 16px;
-    }
-  }
-
   @media (max-width: 759px) {
     #leftColumn.open ~ #ktl-main #searchBar {
       display: none;

From b0af3a0cdc6a8ce68f07c594131cf575ae60065b Mon Sep 17 00:00:00 2001
From: berezinant <berezinant@gmail.com>
Date: Tue, 25 Feb 2025 12:42:35 +0100
Subject: [PATCH 5/6] fix: adjusted dokka template styles

---
 .../js/page/dokka-template/control-pane.scss   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/static/js/page/dokka-template/control-pane.scss b/static/js/page/dokka-template/control-pane.scss
index 4bd8ac35ed1..95ea462174b 100644
--- a/static/js/page/dokka-template/control-pane.scss
+++ b/static/js/page/dokka-template/control-pane.scss
@@ -10,6 +10,24 @@
     }
   }
 
+  @media (max-width: 899px) and (min-width: 760px) {
+    .library-name--link {
+      margin-left: 32px !important;
+    }
+
+    .navigation-controls {
+      padding-right: 18px;
+    }
+
+    .navigation-controls--btn_toc {
+      margin-right: 18px;
+    }
+
+    .library-version {
+      padding-left: 32px !important;
+    }
+  }
+
   .library-name--link::before {
     display: none;
   }

From 138541f9cbf32a113690934ffae0ec8dcc775f79 Mon Sep 17 00:00:00 2001
From: berezinant <berezinant@gmail.com>
Date: Tue, 25 Feb 2025 16:23:56 +0100
Subject: [PATCH 6/6] fix: adjusted navigation styles for dokka

---
 static/js/page/dokka-template/control-pane.scss | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/static/js/page/dokka-template/control-pane.scss b/static/js/page/dokka-template/control-pane.scss
index 95ea462174b..cc792f8aa7f 100644
--- a/static/js/page/dokka-template/control-pane.scss
+++ b/static/js/page/dokka-template/control-pane.scss
@@ -4,6 +4,8 @@
     position: relative;
     z-index: 10;
 
+    background-color: #1b1b1b;
+
     @media (min-width: 940px) {
       min-height: 70px; /* KTL-1147 */
       box-sizing: border-box;
@@ -47,6 +49,10 @@
   }
 }
 
+.theme-dark .root .navigation {
+  background-color: #262628;
+}
+
 .core-api #searchBar {
   display: none !important;
 }