_nav.yml

# Header navigation
# ====================
main:
  content:
    - url: /docs/reference/
      title: Learn

    - url: /community/
      title: Community

    - url: https://play.kotlinlang.org
      title: Try Online


# Docs section navigation
# =======================
subnav:
  content:
    - url: /docs/
      content:
        - url: /docs/reference/
          title: Reference

        - url: /docs/tutorials/
          title: Tutorials

        - url: /docs/books.html
          title: Books

        - url: /docs/resources.html
          title: More resources
    - url: /community/
      content:
        - url: /community/
          urlPattern: ^/community/$
          title: Community Overview

        - url: /user-groups/user-group-list.html
          urlPattern: /user-groups*
          title: User Groups

        - url: /community/kotlin-nights.html
          title: Kotlin Nights

        - url: /community/talks.html
          title: Talks

# Reference navigation
# ====================
reference:
  content:
    - title: Overview
      description: Overview of Kotlin
      content:
        - url: /docs/reference/server-overview.html
          title: Kotlin for Server Side
        - url: /docs/reference/android-overview.html
          title: Kotlin for Android
        - url: /docs/reference/js-overview.html
          title: Kotlin for JavaScript
        - url: /docs/reference/native-overview.html
          title: Kotlin for Native
        - url: /docs/reference/data-science-overview.html
          title: Kotlin for Data Science
        - url: /docs/reference/coroutines-overview.html
          title: Coroutines
        - url: /docs/reference/multiplatform.html
          title: Multiplatform
        - url: /docs/reference/whatsnew11.html
          title: What's New in 1.1
        - url: /docs/reference/whatsnew12.html
          title: What's New in 1.2
        - url: /docs/reference/whatsnew13.html
          title: What's New in 1.3

    - title: Getting Started
      description: Get familiar with the basics of Kotlin including operations, coding conventions and idioms.
      content:
        - url: /docs/reference/basic-syntax.html
          title: Basic Syntax
        - url: /docs/reference/idioms.html
          title: Idioms
        - url: /docs/reference/coding-conventions.html
          title: Coding Conventions

    - title: Basics
      description: The Basics
      content:
        - url: /docs/reference/basic-types.html
          title: Basic Types
        - url: /docs/reference/packages.html
          title: Packages and Imports
        - url: /docs/reference/control-flow.html
          title: Control Flow
        - url: /docs/reference/returns.html
          title: Returns and Jumps

    - title: Classes and Objects
      description: All about objects
      content:
        - url: /docs/reference/classes.html
          title: Classes and Inheritance
        - url: /docs/reference/properties.html
          title: Properties and Fields
        - url: /docs/reference/interfaces.html
          title: Interfaces
        - url: /docs/reference/visibility-modifiers.html
          title: Visibility Modifiers
        - url: /docs/reference/extensions.html
          title: Extensions
        - url: /docs/reference/data-classes.html
          title: Data Classes
        - url: /docs/reference/sealed-classes.html
          title: Sealed Classes
        - url: /docs/reference/generics.html
          title: Generics
        - url: /docs/reference/nested-classes.html
          title: Nested Classes
        - url: /docs/reference/enum-classes.html
          title: Enum Classes
        - url: /docs/reference/object-declarations.html
          title: Objects
        - url: /docs/reference/type-aliases.html
          title: Type Aliases
        - url: /docs/reference/inline-classes.html
          title: Inline Classes
        - url: /docs/reference/delegation.html
          title: Delegation
        - url: /docs/reference/delegated-properties.html
          title: Delegated Properties

    - title: Functions and Lambdas
      description: All about functions
      content:
        - url: /docs/reference/functions.html
          title: Functions
        - url: /docs/reference/lambdas.html
          title: Lambdas
        - url: /docs/reference/inline-functions.html
          title: Inline Functions

    - title: Collections
      description: Kotlin stlib collections
      content:
        - url: /docs/reference/collections-overview.html
          title: Collections Overview
        - url: /docs/reference/constructing-collections.html
          title: Constructing Collections
        - url: /docs/reference/iterators.html
          title: Iterators
        - url: /docs/reference/ranges.html
          title: Ranges and Progressions
        - url: /docs/reference/sequences.html
          title: Sequences
        - url: /docs/reference/collection-operations.html
          title: Operations Overview
        - url: /docs/reference/collection-transformations.html
          title: Transformations
        - url: /docs/reference/collection-filtering.html
          title: Filtering
        - url: /docs/reference/collection-plus-minus.html
          title: Plus and Minus Operators
        - url: /docs/reference/collection-grouping.html
          title: Grouping
        - url: /docs/reference/collection-parts.html
          title: Retrieving Collection Parts
        - url: /docs/reference/collection-elements.html
          title: Retrieving Single Elements
        - url: /docs/reference/collection-ordering.html
          title: Ordering
        - url: /docs/reference/collection-aggregate.html
          title: Aggregate Operations
        - url: /docs/reference/collection-write.html
          title: Collection Write Operations
        - url: /docs/reference/list-operations.html
          title: List Specific Operations
        - url: /docs/reference/set-operations.html
          title: Set Specific Operations
        - url: /docs/reference/map-operations.html
          title: Map Specific Operations

    - title: Multiplatform Programming
      description: Reusing code across JVM, JS, and Native
      content:
        - url: /docs/reference/platform-specific-declarations.html
          title: Platform-Specific Declarations
        - url: /docs/reference/building-mpp-with-gradle.html
          title: Building with Gradle

    - title: Other
      description: Various bits and bobs
      content:
        - url: /docs/reference/multi-declarations.html
          title: Destructuring Declarations
        - url: /docs/reference/typecasts.html
          title: Type Checks and Casts
        - url: /docs/reference/this-expressions.html
          title: This expressions
        - url: /docs/reference/equality.html
          title: Equality
        - url: /docs/reference/operator-overloading.html
          title: Operator overloading
        - url: /docs/reference/null-safety.html
          title: Null Safety
        - url: /docs/reference/exceptions.html
          title: Exceptions
        - url: /docs/reference/annotations.html
          title: Annotations
        - url: /docs/reference/reflection.html
          title: Reflection
        - url: /docs/reference/scope-functions.html
          title: Scope Functions
        - url: /docs/reference/type-safe-builders.html
          title: Type-Safe Builders
        - url: /docs/reference/experimental.html
          title: Experimental API Markers

    - title: Core Libraries
      content:
        - url: /api/latest/jvm/stdlib/index.html
          title: Standard Library
        - url: /api/latest/kotlin.test/index.html
          title: kotlin.test

    - title: Reference
      description: Grammar and other information
      content:
        - url: /docs/reference/keyword-reference.html
          title: Keywords and Operators
        - url: /docs/reference/grammar.html
          title: Grammar


    - title: Java Interop
      description: What you need to know about interoperability with Java.
      content:
        - url: /docs/reference/java-interop.html
          title: Calling Java from Kotlin
        - url: /docs/reference/java-to-kotlin-interop.html
          title: Calling Kotlin from Java

    - title: JavaScript
      description: Using Kotlin with JavaScript
      content:
       - url: /docs/reference/js-project-setup.html
         title: Setting Up a Project
       - url: /docs/reference/dynamic-type.html
         title: Dynamic Type
       - url: /docs/reference/js-interop.html
         title: Calling JavaScript from Kotlin
       - url: /docs/reference/js-to-kotlin-interop.html
         title: Calling Kotlin from JavaScript
       - url: /docs/reference/js-modules.html
         title: JavaScript Modules
       - url: /docs/reference/js-reflection.html
         title: JavaScript Reflection
       - url: /docs/reference/javascript-dce.html
         title: JavaScript DCE

    - title: Native
      description: Using Kotlin/Native for iOS and Native
      external:
        path: kotlin-native
        nav: _nav_reference.yml
        base: /docs/reference/native
        repo: https://github.com/JetBrains/kotlin-native
        branch: v1.3.50-fixes

    - title: Coroutines
      description: Kotlin Coroutines Library
      external:
        path: kotlinx.coroutines/docs
        nav: _nav.yml
        base: /docs/reference/coroutines
        repo: https://github.com/kotlin/kotlinx.coroutines
        branch: master

    - title: Tools
      description:
      content:
  #      - /docs/reference/kotlin-build-tools.html: Kotlin Build Tools
        - url: /docs/reference/kotlin-doc.html
          title: Documenting Kotlin Code
        - url: /docs/reference/kapt.html
          title: Using Kapt
        - url: /docs/reference/compiler-reference.html
          title: Kotlin Сompiler Options
        - url: /docs/reference/using-gradle.html
          title: Using Gradle
        - url: /docs/reference/using-maven.html
          title: Using Maven
        - url: /docs/reference/using-ant.html
          title: Using Ant
        - url: /docs/reference/kotlin-osgi.html
          title: Kotlin and OSGi
        - url: /docs/reference/compiler-plugins.html
          title: Compiler plugins
        - url: /docs/reference/code-style-migration-guide.html
          title: Coding Conventions

    - title: Evolution
      description: Langauge evolution and compatibility
      content:
        - url: /docs/reference/evolution/kotlin-evolution.html
          title: Kotlin Evolution
        - url: /docs/reference/evolution/components-stability.html
          title: Stability of different components
        - url: /docs/reference/compatibility-guide-13.html
          title: Compatibility Guide for Kotlin 1.3

    - title: FAQ
      description: Every question you could possibly think of, might be answered.
      content:
        - url: /docs/reference/faq.html
          title: FAQ
        - url: /docs/reference/comparison-to-java.html
          title: Comparison to Java



# Tutorials navigation
# ====================
tutorials:
  content:
    - title: Getting Started
      content:
        - url: /docs/tutorials/getting-started.html
          title: Getting Started with IntelliJ IDEA
        - url: /docs/tutorials/getting-started-eclipse.html
          title: Getting Started with Eclipse
        - url: /docs/tutorials/command-line.html
          title: Working with the Command Line Compiler
        - url: /docs/tutorials/quick-run.html
          title: Running Code Snippets
        - url: /docs/tutorials/build-tools.html
          title: Working with Build Tools
        - url: /docs/tutorials/koans.html
          title: Koans
        - url: /docs/tutorials/competitive-programming.html
          title: Competitive Programming
    - title: Android
      content:
        - url: /docs/tutorials/kotlin-android.html
          title: Getting Started With Android Development
        - url: /docs/tutorials/android-plugin.html
          title: Kotlin Android Extensions
        - url: /docs/tutorials/android-frameworks.html
          title: Android Frameworks
    - title: Java Interop
      content:
        - url: /docs/tutorials/mixing-java-kotlin-intellij.html
          title: Mixing Java and Kotlin in one project
    - title: JavaScript
      content:
        - url: /docs/tutorials/javascript/kotlin-to-javascript/kotlin-to-javascript.html
          title: Kotlin to JavaScript
        - url: /docs/tutorials/javascript/getting-started-gradle/getting-started-with-gradle.html
          title: Getting Started with Gradle
        - url: /docs/tutorials/javascript/getting-started-idea/getting-started-with-intellij-idea.html
          title: Getting Started with IntelliJ IDEA
        - url: /docs/tutorials/javascript/getting-started-maven/getting-started-with-maven.html
          title: Getting Started with Maven
        - url: /docs/tutorials/javascript/getting-started-command-line/command-line-library-js.html
          title: Creating a Kotlin JavaScript library with the Command Line Compiler
        - url: /docs/tutorials/javascript/working-with-modules/working-with-modules.html
          title: Working with Kotlin and JavaScript Modules
        - url: /docs/tutorials/javascript/working-with-javascript.html
          title: Working with JavaScript
        - url: /docs/tutorials/javascript/debugging-javascript/debugging-javascript.html
          title: Debugging Kotlin in browser
        - url: /docs/tutorials/javascript/react-and-kotlin-js.html
          title: Building Web Applications with React and Kotlin/JS

    - title: Multiplatform Projects
      content:
        - url: /docs/tutorials/mpp/intro-to-kotlin-mpp.html
          title: "Intro to MPP"
        - url: /docs/tutorials/native/mpp-ios-android.html
          title: "iOS and Android"
        - url: /docs/tutorials/mpp/multiplatform-library.html
          title: Multiplatform Library

    - title: Native
      content:
        - url: /docs/tutorials/native/intro-to-kotlin-native.html
          title: Introduction to Kotlin/Native
        - url: /docs/tutorials/native/basic-kotlin-native-app.html
          title: Basic Kotlin/Native Application
        - url: /docs/tutorials/native/mapping-primitive-data-types-from-c.html
          title: Mapping Primitive Data Types from C
        - url: /docs/tutorials/native/mapping-struct-union-types-from-c.html
          title: Mapping Struct and Union Types from C
        - url: /docs/tutorials/native/mapping-function-pointers-from-c.html
          title: Mapping Function Pointers from C
        - url: /docs/tutorials/native/mapping-strings-from-c.html
          title: Mapping Strings from C
        - url: /docs/tutorials/native/dynamic-libraries.html
          title: Kotlin/Native as a Dynamic Library
        - url: /docs/tutorials/native/apple-framework.html
          title: Kotlin/Native as an Apple Framework
        - url: /docs/tutorials/mpp/multiplatform-library.html
          title: Publishing a Kotlin/Native Library
        - url: /docs/tutorials/native/curl.html
          title: Using C Interop and libcurl for an App
        - url: /docs/tutorials/native/mpp-ios-android.html
          title: Building iOS and Android App

    - title: Coroutines
      content:
        - url: /docs/tutorials/coroutines/async-programming.html
          title: Asynchronous Programming
        - url: /docs/tutorials/coroutines/coroutines-basic-jvm.html
          title: Intro to Kotlin Coroutines on the JVM
        - url: /docs/tutorials/coroutines/intro-to-coroutines-and-channels.html
          title: Intro to Coroutines and Channels

    - title: Web Development
      content:
        - url: /docs/tutorials/httpservlets.html
          title: Creating Web Applications with Http Servlets
        - url: /docs/tutorials/spring-boot-restful.html
          title: Creating a RESTful Web Service with Spring Boot

    - title: Tools
      content:
        - url: /docs/tutorials/kotlin-and-ci.html
          title: Setting up Kotlin on TeamCity

    - title: Education
      content:
        - url: /docs/tutorials/edu-tools-learner.html
          title: Learning Kotlin with EduTools plugin
        - url: /docs/tutorials/edu-tools-educator.html
          title: Teaching Kotlin with EduTools plugin
    - title: Migrating from Python
      external:
        path: kotlin-for-python-developers
        nav: kotlinlang.org.yaml
        base: /docs/tutorials/kotlin-for-py
        branch: master
        repo: https://github.com/Khan/kotlin-for-python-developers
        type: tutorial
        wrap_code_snippets: True
        github_edit_page: README.md

foundation:
  content:
    - url: /foundation/kotlin-foundation.html
      title: Kotlin Foundation
    - url: /foundation/language-committee-guidelines.html
      title: Language Committee Guidelines
    - url: /foundation/submitting-incompatible-changes.html
      title: Submitting Incompatible Changes
    - url: /foundation/guidelines.html
      title: Kotlin Brand Usage Guidelines
    - url: /foundation/faq.html
      title: FAQ

groups:
  content:
    - url: /user-groups/user-group-list.html
      title: Kotlin User Groups List
    - url: /user-groups/support.html
      title: Support and Guidelines
    - url: /user-groups/branding.html
      title: Branding