README.md

저장소 소유자(이하 필자)가 개인적으로 코틀린 공부를 위해 시작한 프로젝트입니다.
필자가 시간이 날 때마다 코틀린 문서에 있는 내용 중 일부를 랜덤하게 번역하며, 그 내용은 이 페이지에서 확인하실 수 있습니다.

개인적으로 공부하려고 노션에 작성하던 것을, 비루한 영어 실력으로 작성된 번역이지만 다른 분들에게 공유하면 좋겠다 싶어 시작한 프로젝트이기 때문에 아직 진행이 그렇게 많이 되지도 않았습니다.

현재 번역을 진행할 계획이 있는 문서(원문)들은 아래와 같습니다:
*필자에 의해 진행되는 순서는 완전히 랜덤합니다.

• Home, Get started
• Kotlin overview 의 하위 문서
• Releases and roadmap 의 하위문서
• Basics 의 하위문서
• Concepts 의 하위문서
• Standard library 의 하위문서
• Official libraries 의 하위문서
• Language reference 하위의 외부 링크가 아닌 문서
• Compilers and plugins 의 하위문서

이 중 번역이 완료된 문서들은 아래와 같습니다:

• Home, Get started
• Basics/
  • Basic syntax
• Concepts/
  • Types/
    • BasicTypes/
      • Overview 를 비롯한 모든 하위문서
  • Packages and imports
  • Classes and objects/
    • Classes
    • Inheritance
    • Interfaces
    • Visibility modifiers
    • Extensions
    • Data classes
    • Sealed classes and interfaces
    • Generics: in, out, where
    • Nested and inner classes
    • Object expressions and declarations
    • Delegation
    • Delegated Properties
  • Functions/
    • Functions
    • Lambdas
    • Inline functions
    • Operator overloading
    • Builders/
      • Type-safe builders
  • Null-safety
  • Equality
  • This expressions
  • Asynchronous programming techniques
  • Coroutines
• Official libraries/Coroutines (kotlinx.coroutines)
  • Coroutines guide 를 비롯한 일부 하위 문서

필자가 번역 프로젝트를 진행/기여해본 경험이 전혀 없어서, 기여를 원하시면 진행을 위한 조언을 같이 부탁드리고자 합니다.

문서가 늘어남에 따라, 하나의 단어에 대한 서로 다른 번역어가 혼재되어있습니다.
작성 중 눈치챈 혼재된 번역어를 아래에 기재하고, 추후 통일하도록 합니다.

• parameter: 매개변수, 파라미터
• extension(function): 확장 함수, 익스텐션
• return: 반환, 리턴

주로 원문의 단어를 존중할지, 우리말로 번역할지에 대한 내용들입니다.

문서 내에서, 오른쪽에 ↗ 표시가 붙은 링크는 모두 원문(영어)으로 링크됩니다.
푸른 색 링크는 링크 대상이 코틀린 문서(kotlinlang.org) 바깥의 페이지임을 의미합니다.
그렇지 않은 모든 링크는 이 번역된 사이트 내의 페이지로 이동됩니다.

Next.js App Router - static export 를 사용합니다.

개발 환경은 node 의 yarn 패키지 매니저를 사용합니다.
yarn 4 (berry) 를 사용하며, Zero-Install 은 사용하지 않습니다.
처음에는 썼었는데 다 하고 푸시하려고 보니 Git 용량 문제가 터져서 filter-repo 한 번 돌렸습니다...

각 문서의 마크다운은 /docs 디렉터리에 있으며, 파일 이름은 실제 공식 코틀린 문서에서 사용하는 것과 동일합니다.
다만, pure 마크다운 문법만으로 구성되지는 않으며 각주 및 기타 기능을 위한 별도 문법이 일부 존재합니다.
당장은 코루틴 문서밖에 없어서 기본적인 각주, 페이지 끝의 '이 페이지가 도움이 되셨나요?' 의 축약형 문법 정도가 있지만, 추후 다른 문서에서 사용되는 탭 등의 기능들도 추가될 가능성이 있습니다.