Merge branch 'master' into packages-and-imports

Author: ElviraMustafina

.claude/skills/add-api-reference/SKILL.md

@@ -28,6 +28,11 @@ object BuildParams {
   const val KOTLINX_IO_ID = "kotlinx-io"
   const val KOTLINX_IO_TITLE = KOTLINX_IO_ID
 
+  const val KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_TAG = "v0.5.1"
+  const val KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_LABEL = "0.5.1"
+  const val KOTLINX_COLLECTIONS_IMMUTABLE_ID = "kotlinx.collections.immutable"
+  const val KOTLINX_COLLECTIONS_IMMUTABLE_TITLE = KOTLINX_COLLECTIONS_IMMUTABLE_ID
+
   const val KOTLIN_RELEASE_TAG = "2.4.0"
   const val KOTLIN_RELEASE_LABEL = KOTLIN_RELEASE_TAG
 
@@ -63,6 +68,7 @@ object BuildParams {
     "api/$KOTLINX_DATETIME_ID",
     "api/$KOTLINX_IO_ID",
     "api/$KOTLINX_METADATA_ID",
+    "api/$KOTLINX_COLLECTIONS_IMMUTABLE_ID",
     "api/${KGP_REFERENCE.urlPart}",
     "api/${API_COMPOSE.urlPart}",
   )

.teamcity/BuildParams.kt

@@ -3,6 +3,9 @@ package references
 import BuildParams.API_COMPOSE
 import BuildParams.KGP_REFERENCE
 import jetbrains.buildServer.configs.kotlin.Project
+import references.builds.kotlinx.collectionsImmutable.KotlinxCollectionsImmutableBuildApiReference
+import references.builds.kotlinx.collectionsImmutable.KotlinxCollectionsImmutableBuildSearchIndex
+import references.builds.kotlinx.collectionsImmutable.KotlinxCollectionsImmutablePrepareDokkaTemplates
 import references.builds.kotlinx.coroutines.KotlinxCoroutinesBuildApiReference
 import references.builds.kotlinx.coroutines.KotlinxCoroutinesBuildSearchIndex
 import references.builds.kotlinx.coroutines.KotlinxCoroutinesPrepareDokkaTemplates
@@ -35,6 +38,10 @@ object BuildApiReferencesProject : Project({
     buildType(KotlinxIOBuildSearchIndex)
     buildType(KotlinxIOPrepareDokkaTemplates)
 
+    buildType(KotlinxCollectionsImmutableBuildApiReference)
+    buildType(KotlinxCollectionsImmutableBuildSearchIndex)
+    buildType(KotlinxCollectionsImmutablePrepareDokkaTemplates)
+
     buildType(KotlinxSerializationBuildApiReference)
     buildType(KotlinxSerializationBuildSearchIndex)
     buildType(KotlinxSerializationPrepareDokkaTemplates)
@@ -54,6 +61,7 @@ object BuildApiReferencesProject : Project({
     vcsRoot(KotlinxCoroutines)
     vcsRoot(KotlinxDatetime)
     vcsRoot(KotlinxIO)
+    vcsRoot(KotlinxCollectionsImmutable)
     vcsRoot(Kotlin)
 
     template(PrepareDokkaTemplate)

.teamcity/references/BuildApiReferencesProject.kt

@@ -0,0 +1,36 @@
+package references.builds.kotlinx.collectionsImmutable
+
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_ID
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_LABEL
+import references.BuildApiPages
+import references.dependsOnDokkaTemplate
+import references.scriptBuildHtml
+import references.scriptDropSnapshot
+import references.vcsRoots.KotlinxCollectionsImmutable
+
+private const val DOKKA_HTML_RESULT = "core/build/dokka/html"
+
+object KotlinxCollectionsImmutableBuildApiReference : BuildApiPages(
+    apiId = KOTLINX_COLLECTIONS_IMMUTABLE_ID,
+    releaseTag = KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_LABEL,
+    pagesRoot = DOKKA_HTML_RESULT,
+    stepDropSnapshot = {
+        scriptDropSnapshot {
+            // language=bash
+            scriptContent = """
+                #!/bin/bash
+                sed -i -E "s/versionSuffix=SNAPSHOT//gi" ./gradle.properties
+            """.trimIndent()
+        }
+    },
+    stepBuildHtml = {
+        scriptBuildHtml { tasks = ":kotlinx-collections-immutable:dokkaGenerate" }
+    },
+    init = {
+        vcs {
+            root(KotlinxCollectionsImmutable)
+        }
+        dependencies {
+            dependsOnDokkaTemplate(KotlinxCollectionsImmutablePrepareDokkaTemplates, "core/dokka-templates")
+        }
+    })

.teamcity/references/builds/kotlinx/collectionsImmutable/KotlinxCollectionsImmutableBuildApiReference.kt

@@ -0,0 +1,25 @@
+package references.builds.kotlinx.collectionsImmutable
+
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_ID
+import templates.TemplateSearchIndex
+
+object KotlinxCollectionsImmutableBuildSearchIndex : TemplateSearchIndex({
+    name = "$KOTLINX_COLLECTIONS_IMMUTABLE_ID search"
+    description = "Build search index for Kotlinx Collections Immutable"
+
+    params {
+        param("env.ALGOLIA_INDEX_NAME", "$KOTLINX_COLLECTIONS_IMMUTABLE_ID")
+    }
+
+    dependencies {
+        dependency(KotlinxCollectionsImmutableBuildApiReference) {
+            snapshot {}
+            artifacts {
+                artifactRules = """
+                    pages.zip!** => dist/api/$KOTLINX_COLLECTIONS_IMMUTABLE_ID/
+                """.trimIndent()
+                cleanDestination = true
+            }
+        }
+    }
+})

.teamcity/references/builds/kotlinx/collectionsImmutable/KotlinxCollectionsImmutableBuildSearchIndex.kt

@@ -0,0 +1,18 @@
+package references.builds.kotlinx.collectionsImmutable
+
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_ID
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_TITLE
+import jetbrains.buildServer.configs.kotlin.BuildType
+import references.templates.PrepareDokkaTemplate
+
+object KotlinxCollectionsImmutablePrepareDokkaTemplates : BuildType({
+    name = "$KOTLINX_COLLECTIONS_IMMUTABLE_ID templates"
+    description = "Build dokka templates for Kotlinx Collections Immutable"
+
+    templates(PrepareDokkaTemplate)
+
+    params {
+        param("env.ALGOLIA_INDEX_NAME", KOTLINX_COLLECTIONS_IMMUTABLE_ID)
+        param("env.API_REFERENCE_NAME", KOTLINX_COLLECTIONS_IMMUTABLE_TITLE)
+    }
+})

.teamcity/references/builds/kotlinx/collectionsImmutable/KotlinxCollectionsImmutablePrepareDokkaTemplates.kt

@@ -0,0 +1,16 @@
+package references.vcsRoots
+
+import BuildParams.KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_TAG
+import common.extensions.VCS
+import jetbrains.buildServer.configs.kotlin.vcs.GitVcsRoot
+
+object KotlinxCollectionsImmutable : GitVcsRoot({
+  name = "kotlinx.collections.immutable vcs root"
+  url = "git@github.com:Kotlin/kotlinx.collections.immutable.git"
+  branch = VCS.tag(KOTLINX_COLLECTIONS_IMMUTABLE_RELEASE_TAG)
+  branchSpec = "+:refs/tags/*"
+  useTagsAsBranches = true
+  authMethod = uploadedKey {
+    uploadedKey = "teamcity"
+  }
+})

.teamcity/references/vcsRoots/KotlinxCollectionsImmutable.kt

@@ -18,7 +18,7 @@ This repository is the source for [https://kotlinlang.org](https://kotlinlang.or
 |-----------------------------------------------------------|----------------------------------------------------------|
 | [Main page](https://kotlinlang.org/)                      | [templates/pages/index.html](templates/pages/index.html) |
 | [Kotlin docs](https://kotlinlang.org/docs/home.html)      | [docs/topics](docs/topics)                               |
-| [Server-side](https://kotlinlang.org/server-side/)        | [pages/server-side](pages/server-side)                   |
+| [Backend](https://kotlinlang.org/backend/)                | [pages/backend](pages/backend)                           |
 | [Multiplatform](https://kotlinlang.org/multiplatform/)    | [pages/multiplatform](pages/multiplatform)               |
 | [Case Studies](https://kotlinlang.org/case-studies/)      | [pages/case-studies](pages/case-studies)                 |
 | [Community](https://kotlinlang.org/community/)            | [pages/community](pages/community)                       | 
@@ -100,7 +100,7 @@ Once you publish a pull request, the changes will be validated by [GitHub Action
 To add a case study, do the following:
 1. Fill the case study info in the [case-studies.yml](/data/case-studies/case-studies.yml) with the next:
    - `id`, a unique identifier for the case study.
-    - `type`, the case study category: either `multiplatform` or `server-side`.
+    - `type`, the case study category: either `multiplatform` or `backend`.
     - `description`, a markdown-enabled text description of the case study (supports # header  **bold** and [links](https://example.com), paragraphs are made with two new lines).
     - `logo` (optional), an array of 0-2 image paths relative to the `/public/` directory.
     - `signature` (optional), an object with `name` and `position` fields for the quote author.

README.md

@@ -0,0 +1,3 @@
+export const KOTLIN_BENCHMARK_TITLE = 'Kotlin Benchmark' as const;
+export const KOTLIN_BENCHMARK_URL = '/benchmark/' as const;
+export const METHODOLOGY_URL = '/benchmark/methodology/' as const;