New

.babelrc

@@ -0,0 +1,4 @@
+{
+  "presets": ["next/babel"],
+  "plugins": ["react-optimized-image/plugin"]
+}

.dockerignore

@@ -0,0 +1,7 @@
+.github
+.idea
+.next
+build
+node_modules
+out
+venv

.env.sample

@@ -0,0 +1,5 @@
+NODE_ENV=development
+INDEX_NAME=%env.INDEX_NAME%
+KEY_FILE_LOCATION=%env.KEY_FILE_LOCATION%
+SEARCH_KEY=%env.SEARCH_KEY%
+SEARCH_USER=%env.SEARCH_USER%

.eslintrc.json

@@ -0,0 +1,8 @@
+{
+  "extends": ["next/core-web-vitals", "prettier"],
+  "rules": {
+    "react/no-unescaped-entities": "off",
+    "@next/next/no-page-custom-font": "off",
+    "@next/next/no-img-element": "off"
+  }
+}

.github/workflows/autoupdate.yml

@@ -0,0 +1,17 @@
+name: autoupdate
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  autoupdate:
+    name: autoupdate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: docker://chinthakagodawita/autoupdate-action:v1
+        env:
+          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+          MERGE_CONFLICT_ACTION: "fail"
+          PR_FILTER: "labelled"
+          PR_LABELS: "keep up-to-date"

.github/workflows/close-stale-pr.yml

@@ -0,0 +1,15 @@
+name: 'Close stale PRs'
+on:
+  schedule:
+    - cron: '0 0 * * *'
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v4
+        with:
+          stale-pr-message: 'This PR is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 7 days.'
+          days-before-stale: 30
+          days-before-close: 7
+          exempt-draft-pr: true

.github/workflows/qodana-code-quality-check.yml

@@ -0,0 +1,20 @@
+name: Qodana Code Quality Check
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  qodana:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: 'Qodana Scan'
+        uses: JetBrains/[email protected]
+        with:
+          args: '-b,qodana.sarif.json,--fail-threshold,3'
+          use-caches: false

.github/workflows/validate-events-data.yml

@@ -0,0 +1,19 @@
+name: Validate Community Events Data
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  validate_community_events_data:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: chrisdickinson/setup-yq@latest
+        with:
+          yq-version: 'v4.9.5'
+      - run: |
+         jsonschema -i <(yq eval --tojson -j data/events.yml) data/schemas/events.json
+         echo "community events data is valid!"

.github/workflows/validate-universites-data.yml

@@ -0,0 +1,19 @@
+name: Validate universities
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  validate_universities_data:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: chrisdickinson/setup-yq@latest
+        with:
+          yq-version: 'v4.9.5'
+      - run: |
+         jsonschema -i <(yq eval --tojson -j data/universities.yml) data/schemas/universities.json
+         echo "Universities data is valid!"

.github/workflows/validate-user-groups-data.yml

@@ -0,0 +1,19 @@
+name: Validate user groups data
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  validate_user_groups_data:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: chrisdickinson/setup-yq@latest
+        with:
+          yq-version: 'v4.9.5'
+      - run: |
+         jsonschema -i <(yq eval --tojson -j data/user-groups.yml) data/schemas/user-groups.json
+         echo "User groups data is valid!"

.github/workflows/verify-samples.yml

@@ -0,0 +1,23 @@
+name: Verify samples
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+jobs:
+  verify_samples:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up JDK
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'zulu'
+      - name: Run a verifier
+        uses: AlexanderPrendota/kotlin-samples-verifier@master
+        with:
+          push-repository: 'https://github.com/JetBrains/kotlin-compiler-server'
+          tag-filter: '#tag="code" & kotlin-runnable="true" & !validate="false"'
+          push-path: 'src/test/resources/test-compile-data/jvm/kotlin-web-site'
+          username: '${{ secrets.KOTLIN_WEB_SITE_TOKEN }}' #token with an access to create PR in push-repository and issue in this repository

.gitignore

@@ -0,0 +1,50 @@
+_nav-mapped.yml
+.DS_Store
+obj/
+_ReSharper.*
+out/
+*.csproj.user
+*.resharper.user
+*.resharper
+*.suo
+*.cache
+*.user
+*.dotsettings
+*.dotsettings.*
+_assets
+~$*
+.DS_Store/
+.idea/workspace.xml
+.idea/uiDesigner.xml
+~$*
+lib/kotlin-runtime.jar
+_site/
+Gemfile.lock
+.bundle
+build
+.gradle
+workspace.xml
+uiDesigner.xml
+*.css.map
+/api/
+.idea
+*.iml
+grammar.xml
+/build/
+node_modules
+pdf/kotlin-docs.pdf
+pdf/kotlin-reference.pdf
+pdf/tmp.html
+*.pyc
+google-credentials.json
+package-lock.json
+.env
+pages/api/
+external/
+assets/externals
+pages/docs/tutorials/kotlin-for-py/
+_teamcity
+dist
+generated
+.next
+.teamcity/*.iml

.npmrc

@@ -0,0 +1 @@
+save-exact = true

.nvmrc

@@ -0,0 +1 @@
+8.3.0

.prettierignore

@@ -0,0 +1,2 @@
+dist
+node_modules

.prettierrc.json

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "tabWidth": 4,
+  "printWidth": 120
+}

.teamcity/BuildParams.kt

@@ -0,0 +1,11 @@
+object BuildParams {
+  const val DOKKA_TEMPLATES_VERSION = "1.9.0-dev-218"
+
+  const val KOTLINX_COROUTINES_RELEASE_TAG = "1.7.1"
+  const val KOTLINX_SERIALIZATION_RELEASE_TAG = "v1.6.0"
+  const val KOTLINX_DATETIME_RELEASE_TAG = "v0.4.0"
+  const val KOTLINX_METADATA_JVM_RELEASE_TAG = "v0.7.0"
+
+  const val SEARCH_APP_ID = "7961PKYRXV"
+  const val SEARCH_INDEX_NAME = "prod_KOTLINLANG_WEBHELP"
+}

.teamcity/README

@@ -0,0 +1,17 @@
+The archive contains settings for a TeamCity project.
+
+To edit the settings in IntelliJ Idea, open the pom.xml and
+select the 'Open as a project' option.
+
+If you want to move this dsl to version control, save it in the
+.teamcity directory.
+
+## Branch specific settings
+Bear in mind that not all the changes there will be applied. For instance, if you add a new project or a build configuration, such changes will be ignored. This happens because TeamCity does not support different sets of projects and build configurations in feature branches.
+You can read more about it [here](https://blog.jetbrains.com/teamcity/2018/01/branch-specific-settings-in-teamcity/).
+
+## How to test a new project or a build configuration.
+Considering described above, it is not possible to see a new project or build configuration until merging PR with DSL changes to the master branch.
+To overcome this without merging, follow the next workaround.
+Set your branch as a default one for the VCS root in versioned settings on the TeamCity configuration.
+It is essential to keep your branch up to date with the master branch to avoid losing any configuration changes from it.

.teamcity/builds/apiReferences/BuildApiReferencesProject.kt

@@ -0,0 +1,57 @@
+package builds.apiReferences
+
+import builds.apiReferences.kotlinx.coroutines.KotlinxCoroutinesBuildApiReference
+import builds.apiReferences.kotlinx.coroutines.KotlinxCoroutinesBuildSearchIndex
+import builds.apiReferences.kotlinx.coroutines.KotlinxCoroutinesPrepareDokkaTemplates
+import builds.apiReferences.kotlinx.datetime.KotlinxDatetimeBuildApiReference
+import builds.apiReferences.kotlinx.datetime.KotlinxDatetimeBuildSearchIndex
+import builds.apiReferences.kotlinx.datetime.KotlinxDatetimePrepareDokkaTemplates
+import builds.apiReferences.kotlinx.serialization.KotlinxSerializationBuildApiReference
+import builds.apiReferences.kotlinx.serialization.KotlinxSerializationBuildSearchIndex
+import builds.apiReferences.kotlinx.serialization.KotlinxSerializationPrepareDokkaTemplates
+import builds.apiReferences.kotlinx.metadataJvm.KotlinxMetadataJvmBuildApiReference
+import builds.apiReferences.kotlinx.metadataJvm.KotlinxMetadataJvmBuildSearchIndex
+import builds.apiReferences.kotlinx.metadataJvm.KotlinxMetadataJvmPrepareDokkaTemplates
+import builds.apiReferences.stdlib.BuildStdlibApiReference
+import builds.apiReferences.stdlib.StdlibPrepareDokkaTemplates
+import builds.apiReferences.templates.BuildApiReference
+import builds.apiReferences.templates.BuildApiReferenceSearchIndex
+import builds.apiReferences.templates.PrepareDokkaTemplate
+import builds.apiReferences.vcsRoots.KotlinxCoroutines
+import builds.apiReferences.vcsRoots.KotlinxSerialization
+import builds.apiReferences.vcsRoots.KotlinxDatetime
+import builds.apiReferences.vcsRoots.Kotlin
+import jetbrains.buildServer.configs.kotlin.Project
+
+object BuildApiReferencesProject : Project({
+  name = "API References"
+  description = "Build API references for kotlinlang.org"
+
+  buildType(KotlinxDatetimeBuildApiReference)
+  buildType(KotlinxDatetimeBuildSearchIndex)
+  buildType(KotlinxDatetimePrepareDokkaTemplates)
+
+  buildType(KotlinxSerializationBuildApiReference)
+  buildType(KotlinxSerializationBuildSearchIndex)
+  buildType(KotlinxSerializationPrepareDokkaTemplates)
+
+  buildType(KotlinxCoroutinesBuildApiReference)
+  buildType(KotlinxCoroutinesBuildSearchIndex)
+  buildType(KotlinxCoroutinesPrepareDokkaTemplates)
+
+  buildType(KotlinxMetadataJvmBuildApiReference)
+  buildType(KotlinxMetadataJvmBuildSearchIndex)
+  buildType(KotlinxMetadataJvmPrepareDokkaTemplates)
+
+  buildType(BuildStdlibApiReference)
+  buildType(StdlibPrepareDokkaTemplates)
+
+  vcsRoot(KotlinxSerialization)
+  vcsRoot(KotlinxCoroutines)
+  vcsRoot(KotlinxDatetime)
+  vcsRoot(Kotlin)
+
+  template(PrepareDokkaTemplate)
+  template(BuildApiReference)
+  template(BuildApiReferenceSearchIndex)
+})

.teamcity/builds/apiReferences/extensions.kt

@@ -0,0 +1,31 @@
+package builds.apiReferences
+
+import jetbrains.buildServer.configs.kotlin.BuildType
+import jetbrains.buildServer.configs.kotlin.Dependencies
+import jetbrains.buildServer.configs.kotlin.FailureAction
+
+fun Dependencies.dependsOnDokkaTemplate(build: BuildType, artifactPath: String = "dokka-templates") {
+  dependency(build) {
+    snapshot {
+      onDependencyFailure = FailureAction.CANCEL
+      onDependencyCancel = FailureAction.CANCEL
+    }
+
+    artifacts {
+      artifactRules = "+:dokka-templates/** => $artifactPath"
+    }
+  }
+}
+
+fun Dependencies.dependsOnDokkaPagesJson(build: BuildType) {
+  dependency(build) {
+    snapshot {
+      onDependencyFailure = FailureAction.CANCEL
+      onDependencyCancel = FailureAction.CANCEL
+    }
+
+    artifacts {
+      artifactRules = "+:pages.zip!scripts/pages.json => api-references"
+    }
+  }
+}

.teamcity/builds/apiReferences/kotlinx/coroutines/KotlinxCoroutinesBuildApiReference.kt

@@ -0,0 +1,24 @@
+package builds.apiReferences.kotlinx.coroutines
+
+import BuildParams.KOTLINX_COROUTINES_RELEASE_TAG
+import builds.apiReferences.dependsOnDokkaTemplate
+import builds.apiReferences.templates.BuildApiReference
+import jetbrains.buildServer.configs.kotlin.BuildType
+
+object KotlinxCoroutinesBuildApiReference : BuildType({
+    name = "kotlinx.coroutines API reference"
+
+    templates(BuildApiReference)
+
+    params {
+        param("release.tag", KOTLINX_COROUTINES_RELEASE_TAG)
+    }
+
+    vcs {
+        root(builds.apiReferences.vcsRoots.KotlinxCoroutines)
+    }
+
+    dependencies {
+        dependsOnDokkaTemplate(KotlinxCoroutinesPrepareDokkaTemplates)
+    }
+})