From c3acaac798298506e504be9c8f5f2920bb30fcf4 Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sat, 4 Jan 2025 13:02:58 +0900
Subject: [PATCH 1/8] Add diff from a17c89bff1e821457dbf1a8a23f32d0d46b7d432

Ref: https://github.com/ruby/www.ruby-lang.org/pull/3427
---
 ko/documentation/index.md | 267 ++++++++++++++++++++++++++------------
 1 file changed, 182 insertions(+), 85 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 1e22137ac7..cd3ea7545d 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -16,27 +16,11 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
 [Ruby를 브라우저에서 시험해 볼 수도 있지만][1], Ruby를 설치하기 위해서
 [설치 설명서](installation/)를 읽어보아도 좋습니다.
 
-### Ruby 언어 문서
-
-Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있는 Ruby 언어 문서가 출발점입니다. 이 문서는 언어의 모든 측면을 다루며, Ruby 프로그래밍 언어를 배우거나 참조할 때 처음으로 찾아봐야 하는 곳입니다. 아래 나열된 다른 자료들은 공식 언어 문서를 보완하거나 다른 형식/스타일/맛으로 Ruby 문서를 제공합니다.
 
 ### 초보자용 문서
 
-[공식 FAQ](faq/)
-: 자주 묻는 질문들을 모았습니다.
-
-[Ruby Koans][2] (영문)
-: Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
-  Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
-  Koans에서는 문화도 가르칩니다.
-
-[Why’s (Poignant) Guide to Ruby][5] (영문)
-: 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
-  책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
-  고전입니다.
-
-[Ruby Essentials][7] (영문)
-: 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는 무료 온라인 책입니다.
+[Try Ruby][1]
+: You can try Ruby right in your browser.
 
 [Learn to Program][8] (영문)
 : Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
@@ -46,27 +30,54 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 : 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
   달린 예제들입니다.
 
+[Ruby in Twenty Minutes][rubyin20]
+: A small Ruby tutorial that should take no more than 20 minutes to
+  complete.
+
+[The Odin Project][odin]
+: An open source full stack curriculum
+
+[excercism][exercism]
+: 120 exercises with automatic analysis and personal mentoring.
+
+[Codecademy][codecademy]
+: Online code bootcamp with a variety of topics. Freeish.
+
 [Ruby For Impatient Nuby][ko-1]
 : 서민구 님이 작성하신 Ruby 초보자를 위한 튜토리얼입니다.
 
 [루비 프로그래밍 언어 FAQ][ko-2]
 : 황대산 님이 정리하신 FAQ입니다.
 
-### 매뉴얼
+### Manuals / Books
+
+#### Beginner
+
+[Programming Ruby 3.3][pickaxe]
+: The seminal work on Ruby in English. Recently updated to Ruby 3.3.
+
+[The Well-Grounded Rubyist][grounded]
+: A tutorial that begins with your first Ruby program and takes you all the way to sophisticated topics like reflection, threading, and recursion.
 
-[Programming Ruby][9] (영문)
-: 영어로 된 독창적인 Ruby 책입니다. [Pragmatic Programmers의 책][10]
-  1판이 무료로 온라인에 공개되어 있습니다.
+#### Intermediate
 
-[The Ruby Programming Wikibook][12] (영문)
-: 초보자와 중급자를 위한 무료 온라인 매뉴얼과 전 언어 레퍼런스입니다.
+[Practical OOD in Ruby (POODR)][poodr]
+: A programmer's tale about how to write object-oriented code.
+
+#### Expert
+
+[Metaprogramming][meta]
+: Explains metaprogramming in a down-to-earth style.
+
+[Ruby Under a Microscope (RUM)][microscope]
+: An illustrated guide to Ruby internals.
 
 ### 참조
 
-[공식 API 문서][docs-rlo-en]
+[공식 API 문서][docs-rlo-en] [(JP)][docs-rlo-jp]
 : 아직 릴리스되지 않은 트렁크를 포함한 여러 Ruby 버전의 공식 언어 문서입니다.
 
-[Ruby C API 레퍼런스][extensions] (영문)
+[Ruby C API 레퍼런스][extensions] (영문) [(JP)][extensions-jp]
 : Ruby의 공식 C API 문서입니다.
   Ruby 개발에 참여하거나, C 확장을 개발할 때 도움이 될 것입니다.
 
@@ -77,6 +88,61 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 [Ruby API][40] (영문)
 : Ruby 클래스, 모듈, 메서드를 편하게 찾고 탐색하세요.
 
+[ruby-doc.org][39]
+: Online API documentation
+
+[DevDocs.io][40]
+: Online API documentation
+
+[Ruby QuickRef][42]
+: The Ruby quick reference
+
+[rubyreferences][43]
+: A full language reference + detailed language changelog. Fantastic.
+
+### Style Guides
+
+[rubystyle.guide][44]
+: RuboCop's Ruby style guide
+
+[RuboCop][45]
+: Automated enforcement of their style guide.
+
+[Shopify][46]
+: Shopify's Ruby style guide
+
+[GitLab][47]
+: Gitlab's Ruby style guide
+
+[Airbnb][48]
+: Airbnb's Ruby style guide
+
+[w3resource][49]
+: W3's Ruby style guide
+
+# Tools
+
+[IRB][50]
+: The interactive Ruby Read-Eval-Print-Loop (REPL)
+
+[Pry][51]
+: An alternative Ruby REPL
+
+[Rake][52]
+: A make-like build utility for Ruby.
+
+[RI][53]
+: (Ruby Information) is the Ruby command-line utility that gives fast and easy on-line access to Ruby documentation.
+
+[RBS][54]
+: Type Signature for Ruby
+
+[TypeProf][55]
+: An experimental type-level Ruby interpreter for testing and understanding Ruby code.
+
+[Steep][56]
+: Static type checker for Ruby.
+
 ### 편집기와 IDE
 
 Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습니다. 하지만,
@@ -84,78 +150,109 @@ Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습
 파일 브라우징 등등) 편집기나 고급 기능(자동완성, 리팩토링, 테스트
 지원 등등)이 있는 통합 개발 환경도 생각해 볼 만합니다.
 
-루비스트들이 주로 사용하는 도구들의 목록입니다.
-
-* Linux, 크로스 플랫폼
-  * [Aptana Studio][19]
-  * [Atom][atom]
-  * [Emacs][20], [Ruby mode][21], [Rsense][22]
-  * [Eric][eric]
-  * [Geany][23]
-  * [gedit][24]
-  * [Kate][kate]
-  * [KDevelop][kdevelop]
-  * [NetBeans][36]
-  * [RubyMine][27]
-  * [SciTe][28]
-  * [Sublime Text][37]
-  * [Vim][25], [vim-ruby][26] 플러그인, [Rsense][22]
+Here is a list of popular editors used by Rubyists, broken up by
+learning curve:
+
+* Days
+  * [Sublime Text][37] (paid)
   * [Visual Studio Code][vscode]
+  * [Zed][zed]
+* Months
+  * [RubyMine][27] (paid)
+* "Years" (as in, you'll spend years still learning things about it)
+  * [Emacs][20] with [Ruby mode][21] or [Enhanced Ruby mode][enh-ruby-mode]
+  * [Vim][25] with [vim-ruby][26] plugin
+  * [NeoVim][neovim]
+
+All of these editors support the Language Server Protocol (LSP),
+either by default or through their LSP plugins. Shopify's
+[ruby-lsp][ruby-lsp] is one of the most popular language servers for
+Ruby and [supports all of the above editors][shopify_lsp].
+
+### Older Reading / Resources
 
-* Windows
-  * [Notepad++][29]
+These links were more prominent but haven't been updated in ages.
 
-* macOS
-  * [TextMate][32]
-  * [BBEdit][33]
-  * [Dash][39] (문서 브라우저)
+[Ruby Koans][2]
+: The Koans walk you along the path to enlightenment in order to learn
+  Ruby. The goal is to learn the Ruby language, syntax, structure, and
+  some common functions and libraries. We also teach you culture.
 
-### 더 읽을거리
+[Ruby Essentials][7]
+: A free on-line book designed to provide a concise
+  and easy to follow guide to learning Ruby.
 
-[Ruby-Doc.org][34]는 Ruby 영문 문서를 포괄적으로 관리하는 사이트입니다. Ruby
-[책들][ko-5]도 출판되어 있습니다. Ruby에
-관한 질문이 있다면, [유저 그룹][ko-3]이나 [페이스북 그룹][ko-4]에서 하실 수 있고
-영어가 되신다면 [메일링 리스트](/ko/community/mailing-lists/)를 사용하실 수도
-있습니다.
+[Why’s (Poignant) Guide to Ruby][5]
+: An unconventional but interesting book that will teach you Ruby
+  through stories, wit, and comics. Originally created by *why the lucky
+  stiff*, this guide remains a classic for Ruby learners.
+
+[Learn Ruby the Hard Way][38]
+: A very good set of exercises with explanations that guide you from
+  the absolute basics of Ruby all the way to OOP and web development.
+
+[Programming Ruby][9]
+: The seminal work on Ruby in English, this first edition of the
+  [Pragmatic Programmers’ book][10] is available for free online.
+
+[The Ruby Programming Wikibook][12]
+: A free online manual with beginner and intermediate content plus a
+  thorough language reference.
 
 [1]: https://try.ruby-lang.org/
 [2]: https://rubykoans.com/
 [5]: https://poignant.guide
-[7]: http://www.techotopia.com/index.php/Ruby_Essentials
-[8]: http://pine.fm/LearnToProgram/
-[9]: http://www.ruby-doc.org/docs/ProgrammingRuby/
+[7]: https://www.techotopia.com/index.php/Ruby_Essentials
+[8]: https://pine.fm/LearnToProgram/
+[9]: https://www.ruby-doc.org/docs/ProgrammingRuby/
 [10]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
-[12]: http://en.wikibooks.org/wiki/Ruby_programming_language
-[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
-[16]: http://www.rubydoc.info/
-[19]: http://www.aptana.com/
-[20]: http://www.gnu.org/software/emacs/
-[21]: http://www.emacswiki.org/emacs/RubyMode
-[22]: http://rsense.github.io/
-[23]: http://www.geany.org/
-[24]: http://projects.gnome.org/gedit/screenshots.html
-[25]: http://www.vim.org/
+[12]: https://en.wikibooks.org/wiki/Ruby_programming_language
+[16]: https://www.rubydoc.info/
+[20]: https://www.gnu.org/software/emacs/
+[21]: https://www.emacswiki.org/emacs/RubyMode
+[25]: https://www.vim.org/
 [26]: https://github.com/vim-ruby/vim-ruby
-[27]: http://www.jetbrains.com/ruby/
-[28]: http://www.scintilla.org/SciTE.html
-[29]: http://notepad-plus-plus.org/
-[32]: http://macromates.com/
-[33]: https://www.barebones.com/products/bbedit/
-[34]: http://ruby-doc.org
-[36]: https://netbeans.org/
-[37]: http://www.sublimetext.com/
+[27]: https://www.jetbrains.com/ruby/
+[34]: https://ruby-doc.org/
+[37]: https://www.sublimetext.com/
 [38]: https://learncodethehardway.org/ruby/
-[39]: http://kapeli.com/dash
-[40]: https://rubyapi.org/
-[docs-rlo-en]: https://docs.ruby-lang.org/en/
-[atom]: https://atom.io/
+[39]: https://www.ruby-doc.org/
+[40]: https://devdocs.io/ruby/
+[42]: https://www.zenspider.com/ruby/quickref.html
+[43]: https://rubyreferences.github.io/
+[44]: https://rubystyle.guide/
+[45]: https://github.com/rubocop/ruby-style-guide
+[46]: https://ruby-style-guide.shopify.dev/
+[47]: https://docs.gitlab.com/ee/development/backend/ruby_style_guide.html
+[48]: https://github.com/airbnb/ruby
+[49]: https://www.w3resource.com/ruby/ruby-style-guide.php
+[50]: https://github.com/ruby/irb
+[51]: https://github.com/pry/pry
+[52]: https://github.com/ruby/rake
+[53]: https://ruby.github.io/rdoc/RI_md.html
+[54]: https://github.com/ruby/rbs
+[55]: https://github.com/ruby/typeprof
+[56]: https://github.com/soutaro/steep
+[codecademy]: https://www.codecademy.com/learn/learn-ruby
+[docs-rlo-en]: https://docs.ruby-lang.org/en/latest
+[docs-rlo-jp]: https://docs.ruby-lang.org/ja/latest
+[enh-ruby-mode]: https://github.com/zenspider/enhanced-ruby-mode/
+[exercism]: https://exercism.org/tracks/ruby
+[extensions-jp]: https://docs.ruby-lang.org/jp/master/extension_rdoc.html
+[extensions]: https://docs.ruby-lang.org/en/master/extension_rdoc.html
+[grounded]: https://www.manning.com/books/the-well-grounded-rubyist-third-edition
+[meta]: https://pragprog.com/titles/ppmetr2/metaprogramming-ruby-2/
+[microscope]: https://patshaughnessy.net/ruby-under-a-microscope
+[neovim]: https://neovim.io/
+[odin]: https://www.theodinproject.com/paths/full-stack-ruby-on-rails/courses/ruby
+[pickaxe]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
+[poodr]: https://www.poodr.com/
+[ruby-lsp]: https://github.com/Shopify/ruby-lsp
+[rubyapi-org]: https://rubyapi.org/
+[rubyin20]: https://www.ruby-lang.org/en/documentation/quickstart/
+[shopify_lsp]: https://shopify.github.io/ruby-lsp/editors.html)
 [vscode]: https://code.visualstudio.com/docs/languages/ruby
-[eric]: https://eric-ide.python-projects.org/
-[kdevelop]: https://www.kdevelop.org/
-[kate]: https://kate-editor.org/
+[zed]: https://zed.dev/
 
 [ko-1]: https://docs.google.com/document/d/15yEpi2ZMB2Lld5lA1TANt13SJ_cKygP314cqyKhELwQ/preview
 [ko-2]: https://web.archive.org/web/20190521035426/http://beyond.daesan.com/pages/ruby-faq
-[ko-3]: https://groups.google.com/forum/#!forum/rubykr
-[ko-4]: https://www.facebook.com/groups/rubykr/
-[ko-5]: http://ruby-korea.github.io/#book

From 08de1246d5cac1970eccb06ef026a4d478f7d811 Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sat, 4 Jan 2025 13:29:28 +0900
Subject: [PATCH 2/8] Translate "First pass at updating
 en/documentation/index.md" (ko)

---
 ko/documentation/index.md | 136 +++++++++++++++++++-------------------
 1 file changed, 68 insertions(+), 68 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index cd3ea7545d..35e8a9e0e4 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -20,7 +20,7 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
 ### 초보자용 문서
 
 [Try Ruby][1]
-: You can try Ruby right in your browser.
+: 브라우저에서 Ruby를 시험해 볼 수 있습니다.
 
 [Learn to Program][8] (영문)
 : Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
@@ -31,17 +31,16 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
   달린 예제들입니다.
 
 [Ruby in Twenty Minutes][rubyin20]
-: A small Ruby tutorial that should take no more than 20 minutes to
-  complete.
+: 20분 이내에 끝낼 수 있는 작은 Ruby 튜토리얼입니다.
 
 [The Odin Project][odin]
-: An open source full stack curriculum
+: 오픈소스 풀스택 커리큘럼입니다.
 
 [excercism][exercism]
-: 120 exercises with automatic analysis and personal mentoring.
+: 자동 분석과 개인 멘토링이 포함된 120개의 연습문제가 제공됩니다.
 
 [Codecademy][codecademy]
-: Online code bootcamp with a variety of topics. Freeish.
+: 다양한 주제를 다루는 온라인 코드 부트캠프입니다. 무료입니다.
 
 [Ruby For Impatient Nuby][ko-1]
 : 서민구 님이 작성하신 Ruby 초보자를 위한 튜토리얼입니다.
@@ -49,28 +48,28 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
 [루비 프로그래밍 언어 FAQ][ko-2]
 : 황대산 님이 정리하신 FAQ입니다.
 
-### Manuals / Books
+### 매뉴얼 / 책
 
-#### Beginner
+#### 초보자
 
 [Programming Ruby 3.3][pickaxe]
-: The seminal work on Ruby in English. Recently updated to Ruby 3.3.
+: 영어로 된 독창적인 Ruby 책입니다. 최근에 Ruby 3.3으로 업데이트되었습니다.
 
 [The Well-Grounded Rubyist][grounded]
-: A tutorial that begins with your first Ruby program and takes you all the way to sophisticated topics like reflection, threading, and recursion.
+: 첫 Ruby 프로그램부터 리플렉션, 스레딩, 재귀 등과 같은 고급 주제까지 다루는 튜토리얼입니다.
 
-#### Intermediate
+#### 중급자
 
 [Practical OOD in Ruby (POODR)][poodr]
-: A programmer's tale about how to write object-oriented code.
+: 한 프로그래머의 객체지향 코드를 작성하는 방법에 대한 이야기입니다.
 
-#### Expert
+#### 전문가
 
 [Metaprogramming][meta]
-: Explains metaprogramming in a down-to-earth style.
+: 메타 프로그래밍을 쉽게 설명합니다.
 
 [Ruby Under a Microscope (RUM)][microscope]
-: An illustrated guide to Ruby internals.
+: Ruby 내부를 설명하는 그림이 포함된 가이드입니다.
 
 ### 참조
 
@@ -89,59 +88,59 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
 : Ruby 클래스, 모듈, 메서드를 편하게 찾고 탐색하세요.
 
 [ruby-doc.org][39]
-: Online API documentation
+: 온라인 API 문서입니다.
 
 [DevDocs.io][40]
-: Online API documentation
+: 온라인 API 문서입니다.
 
 [Ruby QuickRef][42]
-: The Ruby quick reference
+: 빠른 Ruby 참조 문서입니다.
 
 [rubyreferences][43]
-: A full language reference + detailed language changelog. Fantastic.
+: 완전한 언어 레퍼런스와 상세한 언어 변경 로그입니다. 훌륭합니다.
 
-### Style Guides
+### 스타일 가이드
 
 [rubystyle.guide][44]
-: RuboCop's Ruby style guide
+: RuboCop의 Ruby 스타일 가이드
 
 [RuboCop][45]
-: Automated enforcement of their style guide.
+: Rubocop의 스타일 가이드를 자동으로 적용합니다.
 
 [Shopify][46]
-: Shopify's Ruby style guide
+: Shopify의 Ruby 스타일 가이드
 
 [GitLab][47]
-: Gitlab's Ruby style guide
+: Gitlab의 Ruby 스타일 가이드
 
 [Airbnb][48]
-: Airbnb's Ruby style guide
+: Airbnb의 Ruby 스타일 가이드
 
 [w3resource][49]
-: W3's Ruby style guide
+: W3의 Ruby 스타일 가이드
 
-# Tools
+# 도구
 
 [IRB][50]
-: The interactive Ruby Read-Eval-Print-Loop (REPL)
+: 대화형 Ruby 셸(Read-Eval-Print-Loop, REPL)입니다.
 
 [Pry][51]
-: An alternative Ruby REPL
+: 또 다른 Ruby REPL입니다.
 
 [Rake][52]
-: A make-like build utility for Ruby.
+: Ruby의 make와 비슷한 빌드 유틸리티입니다.
 
 [RI][53]
-: (Ruby Information) is the Ruby command-line utility that gives fast and easy on-line access to Ruby documentation.
+: RI(Ruby Information)는 Ruby의 명령줄 유틸리티로 Ruby 문서에 빠르고 쉽게 접근할 수 있습니다.
 
 [RBS][54]
-: Type Signature for Ruby
+: Ruby의 타입 시그니처입니다.
 
 [TypeProf][55]
-: An experimental type-level Ruby interpreter for testing and understanding Ruby code.
+: Ruby 코드를 테스트하고 이해하기 위한 실험적인 타입 수준의 Ruby 인터프리터입니다.
 
 [Steep][56]
-: Static type checker for Ruby.
+: Ruby의 정적 타입 검사기입니다.
 
 ### 편집기와 IDE
 
@@ -150,54 +149,55 @@ Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습
 파일 브라우징 등등) 편집기나 고급 기능(자동완성, 리팩토링, 테스트
 지원 등등)이 있는 통합 개발 환경도 생각해 볼 만합니다.
 
-Here is a list of popular editors used by Rubyists, broken up by
-learning curve:
+루비스트가 사용하는 인기 있는 편집기 목록을
+학습 곡선에 따라 나누어 놓았습니다.
 
-* Days
+
+* 며칠 안에 익힐 수 있는 편집기
   * [Sublime Text][37] (paid)
   * [Visual Studio Code][vscode]
   * [Zed][zed]
-* Months
+* 몇 개월 정도 걸리는 편집기
   * [RubyMine][27] (paid)
-* "Years" (as in, you'll spend years still learning things about it)
-  * [Emacs][20] with [Ruby mode][21] or [Enhanced Ruby mode][enh-ruby-mode]
-  * [Vim][25] with [vim-ruby][26] plugin
+* "몇 년" (즉, 몇 년 동안 새로운 것을 계속 배울 수 있는 에디터)
+  * [Ruby 모드][21]이나 [향상된 Ruby 모드][enh-ruby-mode]를 사용하는 [Emacs][20]
+  * [vim-ruby][26] 플러그인을 사용하는 [Vim][25]
   * [NeoVim][neovim]
 
-All of these editors support the Language Server Protocol (LSP),
-either by default or through their LSP plugins. Shopify's
-[ruby-lsp][ruby-lsp] is one of the most popular language servers for
-Ruby and [supports all of the above editors][shopify_lsp].
+위에서 언급한 모든 편집기는 기본으로 또는 LSP 플러그인을 통해
+언어 서버 프로토콜(LSP)을 지원합니다. Shopify의 [ruby-lsp][ruby-lsp]는
+Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
+[위에서 언급한 모든 편집기를 지원합니다][shopify_lsp].
 
-### Older Reading / Resources
+### 오래된 문서 / 리소스
 
-These links were more prominent but haven't been updated in ages.
+다음 링크들은 한때 더 주목받았지만 오랫동안 업데이트되지 않았습니다.
 
-[Ruby Koans][2]
-: The Koans walk you along the path to enlightenment in order to learn
-  Ruby. The goal is to learn the Ruby language, syntax, structure, and
-  some common functions and libraries. We also teach you culture.
+[Ruby Koans][2] (영문)
+: Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
+  Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
+  Koans에서는 문화도 가르칩니다.
 
-[Ruby Essentials][7]
-: A free on-line book designed to provide a concise
-  and easy to follow guide to learning Ruby.
+[Ruby Essentials][7] (영문)
+: 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는
+  무료 온라인 책입니다.
 
-[Why’s (Poignant) Guide to Ruby][5]
-: An unconventional but interesting book that will teach you Ruby
-  through stories, wit, and comics. Originally created by *why the lucky
-  stiff*, this guide remains a classic for Ruby learners.
+[Why’s (Poignant) Guide to Ruby][5] (영문)
+: 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
+  책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
+  고전입니다.
 
-[Learn Ruby the Hard Way][38]
-: A very good set of exercises with explanations that guide you from
-  the absolute basics of Ruby all the way to OOP and web development.
+[Learn Ruby the Hard Way][38] (영문)
+: 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
+  달린 예제들입니다.
 
-[Programming Ruby][9]
-: The seminal work on Ruby in English, this first edition of the
-  [Pragmatic Programmers’ book][10] is available for free online.
+[Programming Ruby][9] (영문)
+: 영어로 된 독창적인 Ruby 책입니다. [Pragmatic Programmers의 책][10]
+  1판이 무료로 온라인에 공개되어 있습니다.
 
-[The Ruby Programming Wikibook][12]
-: A free online manual with beginner and intermediate content plus a
-  thorough language reference.
+[The Ruby Programming Wikibook][12] (영문)
+: 초보자와 중급자를 위한 무료 온라인 매뉴얼과
+  언어 전체 레퍼런스입니다.
 
 [1]: https://try.ruby-lang.org/
 [2]: https://rubykoans.com/
@@ -249,7 +249,7 @@ These links were more prominent but haven't been updated in ages.
 [poodr]: https://www.poodr.com/
 [ruby-lsp]: https://github.com/Shopify/ruby-lsp
 [rubyapi-org]: https://rubyapi.org/
-[rubyin20]: https://www.ruby-lang.org/en/documentation/quickstart/
+[rubyin20]: https://www.ruby-lang.org/ko/documentation/quickstart/
 [shopify_lsp]: https://shopify.github.io/ruby-lsp/editors.html)
 [vscode]: https://code.visualstudio.com/docs/languages/ruby
 [zed]: https://zed.dev/

From e0fa6e79e3dd52ac4d3927e1c350b4f213d7d23a Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sun, 12 Jan 2025 09:12:16 +0900
Subject: [PATCH 3/8] Restore first section

---
 ko/documentation/index.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 35e8a9e0e4..40b074793c 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -16,6 +16,9 @@ Ruby를 배울 수 있는 매뉴얼과 튜토리얼, 코딩할 때 도움이 되
 [Ruby를 브라우저에서 시험해 볼 수도 있지만][1], Ruby를 설치하기 위해서
 [설치 설명서](installation/)를 읽어보아도 좋습니다.
 
+### Ruby 언어 문서
+
+Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있는 Ruby 언어 문서가 출발점입니다. 이 문서는 언어의 모든 측면을 다루며, Ruby 프로그래밍 언어를 배우거나 참조할 때 처음으로 찾아봐야 하는 곳입니다. 아래 나열된 다른 자료들은 공식 언어 문서를 보완하거나 다른 형식/스타일/맛으로 Ruby 문서를 제공합니다.
 
 ### 초보자용 문서
 

From 4b849080484163b821c62a57ced6867e2e9bc8e4 Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sun, 12 Jan 2025 09:13:48 +0900
Subject: [PATCH 4/8] Remove old "Learn Ruby the Hard Way"
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

which is moved to "오래된 문서"
---
 ko/documentation/index.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 40b074793c..b0a8973593 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -29,10 +29,6 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 : Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
   프로그래밍을 모르신다면 여기서 시작하세요.
 
-[Learn Ruby the Hard Way][38] (영문)
-: 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
-  달린 예제들입니다.
-
 [Ruby in Twenty Minutes][rubyin20]
 : 20분 이내에 끝낼 수 있는 작은 Ruby 튜토리얼입니다.
 

From 4e05ac932a9c35f39994e194037dcb7e7abcba13 Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sun, 12 Jan 2025 09:18:18 +0900
Subject: [PATCH 5/8] Apply suggestions from code review

Co-authored-by: Chayoung You <yousbe@gmail.com>
---
 ko/documentation/index.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index b0a8973593..7bb491dddf 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -60,12 +60,12 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 #### 중급자
 
 [Practical OOD in Ruby (POODR)][poodr]
-: 한 프로그래머의 객체지향 코드를 작성하는 방법에 대한 이야기입니다.
+: 객체지향 코드를 작성하는 방법에 대한 프로그래머의 이야기입니다.
 
 #### 전문가
 
 [Metaprogramming][meta]
-: 메타 프로그래밍을 쉽게 설명합니다.
+: 메타 프로그래밍을 실용적인 방식으로 설명합니다.
 
 [Ruby Under a Microscope (RUM)][microscope]
 : Ruby 내부를 설명하는 그림이 포함된 가이드입니다.
@@ -104,13 +104,13 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 : RuboCop의 Ruby 스타일 가이드
 
 [RuboCop][45]
-: Rubocop의 스타일 가이드를 자동으로 적용합니다.
+: RuboCop의 스타일 가이드를 자동으로 적용합니다.
 
 [Shopify][46]
 : Shopify의 Ruby 스타일 가이드
 
 [GitLab][47]
-: Gitlab의 Ruby 스타일 가이드
+: GitLab의 Ruby 스타일 가이드
 
 [Airbnb][48]
 : Airbnb의 Ruby 스타일 가이드
@@ -150,16 +150,14 @@ Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습
 
 루비스트가 사용하는 인기 있는 편집기 목록을
 학습 곡선에 따라 나누어 놓았습니다.
-
-
 * 며칠 안에 익힐 수 있는 편집기
-  * [Sublime Text][37] (paid)
+  * [Sublime Text][37] (유료)
   * [Visual Studio Code][vscode]
   * [Zed][zed]
 * 몇 개월 정도 걸리는 편집기
-  * [RubyMine][27] (paid)
+  * [RubyMine][27] (유료)
 * "몇 년" (즉, 몇 년 동안 새로운 것을 계속 배울 수 있는 에디터)
-  * [Ruby 모드][21]이나 [향상된 Ruby 모드][enh-ruby-mode]를 사용하는 [Emacs][20]
+  * [Ruby 모드][21]나 [향상된 Ruby 모드][enh-ruby-mode]를 사용하는 [Emacs][20]
   * [vim-ruby][26] 플러그인을 사용하는 [Vim][25]
   * [NeoVim][neovim]
 

From 397d7d2bd87a2fc0df2582489744b4bc7dc8fd8b Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sun, 12 Jan 2025 09:21:52 +0900
Subject: [PATCH 6/8] Update ko/documentation/index.md

Co-authored-by: Chayoung You <yousbe@gmail.com>
---
 ko/documentation/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 7bb491dddf..7c5198785c 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -247,7 +247,7 @@ Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
 [ruby-lsp]: https://github.com/Shopify/ruby-lsp
 [rubyapi-org]: https://rubyapi.org/
 [rubyin20]: https://www.ruby-lang.org/ko/documentation/quickstart/
-[shopify_lsp]: https://shopify.github.io/ruby-lsp/editors.html)
+[shopify_lsp]: https://shopify.github.io/ruby-lsp/editors.html
 [vscode]: https://code.visualstudio.com/docs/languages/ruby
 [zed]: https://zed.dev/
 

From 86bc284e15a123f927ae9676ffb2b43eab4efb21 Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Sun, 12 Jan 2025 09:23:08 +0900
Subject: [PATCH 7/8] =?UTF-8?q?Remove=20all=20"(=EC=98=81=EB=AC=B8)"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ko/documentation/index.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 7c5198785c..5c4bac727a 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -25,7 +25,7 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 [Try Ruby][1]
 : 브라우저에서 Ruby를 시험해 볼 수 있습니다.
 
-[Learn to Program][8] (영문)
+[Learn to Program][8]
 : Chris Pine 님이 작성한 초보자를 위한 작고 멋진 튜토리얼입니다.
   프로그래밍을 모르신다면 여기서 시작하세요.
 
@@ -75,15 +75,15 @@ Ruby를 이해하고 싶다면, [docs.ruby-lang.org][docs-rlo-en]의 권위 있
 [공식 API 문서][docs-rlo-en] [(JP)][docs-rlo-jp]
 : 아직 릴리스되지 않은 트렁크를 포함한 여러 Ruby 버전의 공식 언어 문서입니다.
 
-[Ruby C API 레퍼런스][extensions] (영문) [(JP)][extensions-jp]
+[Ruby C API 레퍼런스][extensions] [(JP)][extensions-jp]
 : Ruby의 공식 C API 문서입니다.
   Ruby 개발에 참여하거나, C 확장을 개발할 때 도움이 될 것입니다.
 
-[RubyDoc.info][16] (영문)
+[RubyDoc.info][16]
 : Ruby gem과 GitHub에서 호스팅 되는 Ruby 프로젝트의 레퍼런스 문서들을
   모아놓은 사이트입니다.
 
-[Ruby API][40] (영문)
+[Ruby API][40]
 : Ruby 클래스, 모듈, 메서드를 편하게 찾고 탐색하세요.
 
 [ruby-doc.org][39]
@@ -170,29 +170,29 @@ Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
 
 다음 링크들은 한때 더 주목받았지만 오랫동안 업데이트되지 않았습니다.
 
-[Ruby Koans][2] (영문)
+[Ruby Koans][2]
 : Koans는 Ruby를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
   Ruby 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
   Koans에서는 문화도 가르칩니다.
 
-[Ruby Essentials][7] (영문)
+[Ruby Essentials][7]
 : 간결하고 따라 하기 쉬운 Ruby 가이드를 제공하는
   무료 온라인 책입니다.
 
-[Why’s (Poignant) Guide to Ruby][5] (영문)
+[Why’s (Poignant) Guide to Ruby][5]
 : 이야기, 재치, 만화를 통해 Ruby를 가르쳐주는 틀에 얽매이지 않는 재미있는
   책입니다. *Why the Lucky Stiff*의 저작물로 Ruby를 배우는 사람을 위한
   고전입니다.
 
-[Learn Ruby the Hard Way][38] (영문)
+[Learn Ruby the Hard Way][38]
 : 아주 기초적인 내용부터 OOP에서 웹 개발까지 다루는 매우 좋은 설명이
   달린 예제들입니다.
 
-[Programming Ruby][9] (영문)
+[Programming Ruby][9]
 : 영어로 된 독창적인 Ruby 책입니다. [Pragmatic Programmers의 책][10]
   1판이 무료로 온라인에 공개되어 있습니다.
 
-[The Ruby Programming Wikibook][12] (영문)
+[The Ruby Programming Wikibook][12]
 : 초보자와 중급자를 위한 무료 온라인 매뉴얼과
   언어 전체 레퍼런스입니다.
 

From 683b99e3b4235bda13ebdce75f1458ca70df8e7e Mon Sep 17 00:00:00 2001
From: Shia <rise.shia@gmail.com>
Date: Fri, 17 Jan 2025 09:23:45 +0900
Subject: [PATCH 8/8] Small update about ruby lsp supported editor link

---
 ko/documentation/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index 5c4bac727a..c8e3b95394 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -164,7 +164,7 @@ Ruby를 코딩할 때 운영체제의 기본 편집기를 사용할 수 있습
 위에서 언급한 모든 편집기는 기본으로 또는 LSP 플러그인을 통해
 언어 서버 프로토콜(LSP)을 지원합니다. Shopify의 [ruby-lsp][ruby-lsp]는
 Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
-[위에서 언급한 모든 편집기를 지원합니다][shopify_lsp].
+[위에서 언급한 모든 편집기를 지원합니다][ruby-lsp-supported-editors].
 
 ### 오래된 문서 / 리소스
 
@@ -245,9 +245,9 @@ Ruby를 위한 가장 인기 있는 언어 서버 중 하나이며,
 [pickaxe]: https://pragprog.com/titles/ruby5/programming-ruby-3-3-5th-edition/
 [poodr]: https://www.poodr.com/
 [ruby-lsp]: https://github.com/Shopify/ruby-lsp
+[ruby-lsp-supported-editors]: https://shopify.github.io/ruby-lsp/editors.html
 [rubyapi-org]: https://rubyapi.org/
 [rubyin20]: https://www.ruby-lang.org/ko/documentation/quickstart/
-[shopify_lsp]: https://shopify.github.io/ruby-lsp/editors.html
 [vscode]: https://code.visualstudio.com/docs/languages/ruby
 [zed]: https://zed.dev/