diff --git a/ko/documentation/index.md b/ko/documentation/index.md
index a3f6866493..9cbbd1ba2e 100644
--- a/ko/documentation/index.md
+++ b/ko/documentation/index.md
@@ -13,24 +13,13 @@ lang: ko
 
 ### 루비 설치하기
 
-브라우저에서만 루비를 시험해 보려는 게 아니라면 (밑의 링크 참조)
-컴퓨터에 루비를 설치할 필요가 있습니다.
-루비가 이미 설치되어 있는지 확인하려면 터미널을 열고 다음 명령어를
-입력하세요.
-
-{% highlight sh %}
-ruby -v
-{% endhighlight %}
-
-이 명령은 설치된 루비에 대한 정보를 알려줄 것입니다.
-설치되어 있지 않다면, [설치 페이지](installation/)에 있는 많은 옵션을
-참조하세요.
+[루비를 브라우저에서 시험해 볼 수도 있지만][1], 루비를 설치하기 위해서
+[설치 설명서](installation/)를 읽어보아도 좋습니다.
 
 ### 초보자용 문서
 
-[Try Ruby!][1] (영문)
-: 초보자를 위한 웹 기반의 대화형 튜토리얼입니다. 루비를 설치하지 않고도
-  브라우저만 있으면 루비를 배울 수 있습니다.
+[공식 FAQ](/en/documentation/faq/) (영문)
+: 자주 묻는 질문들을 모았습니다.
 
 [Ruby Koans][2] (영문)
 : Koans는 루비를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
@@ -42,10 +31,6 @@ ruby -v
   책입니다. *Why the Lucky Stiff*의 저작물로 루비를 배우는 사람을 위한
   고전입니다.
 
-[루비 20분 가이드](/ko/documentation/quickstart/)
-: 루비의 기초를 다루는 튜토리얼입니다. 처음부터 끝까지 읽는 데 20분도 걸리지
-  않습니다.
-
 [Learning Ruby][6] (영문)
 : 새로 언어를 배우는 사람이나 루비의 개념과 구조를 검색하려는 사람들을 위한
   루비 스터디 노트들입니다.
@@ -68,10 +53,6 @@ ruby -v
 [루비 FAQ][ko-2]
 : 황대산 님이 정리하신 FAQ입니다.
 
-[다른 언어로 부터의 루비](/ko/documentation/ruby-from-other-languages/)
-: 다른 언어를 하시다 루비로 오셨나요? C, C++, Java, Perl, PHP, Python에
-  상관없이 이 글이면 충분합니다.
-
 ### 매뉴얼
 
 [프로그래밍 루비][9] (영문)
@@ -88,6 +69,9 @@ ruby -v
 
 ### 참조
 
+[공식 API 문서][40]
+: 아직 릴리스되지 않은 트렁크를 포함한 여러 루비 버전의 공식 API 문서입니다.
+
 [루비 코어 레퍼런스][13] (영문)
 : [RDoc][14]을 이용해 소스에서 추출한 레퍼런스입니다. String, Array,
   Symbol 등 모든 코어 클래스와 모듈에 대한 문서를 찾아볼 수 있습니다.
@@ -96,6 +80,10 @@ ruby -v
 : 마찬가지로 RDoc을 이용해 소스에서 추출한 것으로 표준 라이브러리에
   대한 레퍼런스입니다.
 
+[루비 C API 레퍼런스][extensions] (영문)
+: 루비의 공식 C API 문서입니다.
+  루비 개발에 참여하거나, C 확장을 개발할 때 도움이 될 것입니다.
+
 [RubyDoc.info][16] (영문)
 : 루비 젬과 GitHub에서 호스팅 되는 루비 프로젝트의 레퍼런스 문서들을
   모아놓은 사이트입니다.
@@ -125,16 +113,19 @@ ruby -v
   * [SciTe][28]
   * [NetBeans][36]
   * [Sublime Text][37]
+  * [Atom][atom]
 
 * Windows
   * [Notepad++][29]
   * [E-TextEditor][30]
   * [Ruby In Steel][31]
+  * [Atom][atom]
 
 * macOS
   * [TextMate][32]
   * [TextWrangler][33]
   * [Dash][39] (문서 브라우저)
+  * [Atom][atom]
 
 ### 더 읽을거리
 
@@ -157,6 +148,7 @@ ruby -v
 [13]: http://www.ruby-doc.org/core
 [14]: https://ruby.github.io/rdoc/
 [15]: http://www.ruby-doc.org/stdlib
+[extensions]: https://docs.ruby-lang.org/en/trunk/extension_rdoc.html
 [16]: http://www.rubydoc.info/
 [17]: http://rubydocs.org/
 [18]: http://apidock.com/
@@ -181,6 +173,8 @@ ruby -v
 [37]: http://www.sublimetext.com/
 [38]: http://ruby.learncodethehardway.org/
 [39]: http://kapeli.com/dash
+[40]: https://docs.ruby-lang.org/en/
+[atom]: https://atom.io/
 [ko-1]: http://docs.google.com/View?docid=ajb44wcvmjj8_2fg33f2
 [ko-2]: http://beyond.daesan.com/pages/ruby-faq
 [ko-3]: https://groups.google.com/forum/#!forum/rubykr
diff --git a/ko/documentation/installation/index.md b/ko/documentation/installation/index.md
index 6390ee76bd..b398634e3c 100644
--- a/ko/documentation/installation/index.md
+++ b/ko/documentation/installation/index.md
@@ -4,12 +4,18 @@ title: "루비 설치하기"
 lang: ko
 ---
 
-루비를 설치할 때 몇 가지 도구를 사용할 수 있습니다.
-이 페이지에서는 루비를 설치하고 관리하는 주요 패키지
-관리 시스템들과 서드파티 도구들의 사용법과
-소스에서 루비를 빌드하는 법을 설명합니다.
+루비를 설치하고 관리할 수 있는 다양한 패키지 관리 시스템들과 서드파티 도구들이 있습니다.
+
 {: .summary}
 
+컴퓨터에 이미 루비가 설치되어 있을 수도 있습니다.
+이를 확인하려면 [터미널][terminal]을 열고 다음 명령어를 입력하세요.
+
+{% highlight sh %}
+ruby -v
+{% endhighlight %}
+
+이 명령은 설치된 루비에 대한 정보를 알려줄 것입니다.
 
 ## 설치 방법 선택하기
 
@@ -32,6 +38,7 @@ lang: ko
   * [Gentoo](#portage)
   * [Arch Linux](#pacman)
   * [macOS](#homebrew)
+  * [FreeBSD](#freebsd)
   * [Solaris, OpenIndiana](#solaris)
   * [다른 배포판](#other-systems)
 * [인스톨러](#installers)
@@ -54,13 +61,11 @@ lang: ko
 루비를 설치하기 위해 자신의 시스템의 패키지 관리자를 사용할 수 있습니다.
 
 루비 커뮤니티의 일부 회원들은 루비를 설치할 때 패키지 관리자를 사용하지
-말아야 하고, 대신 도구를 사용해야 한다고 강하게 느끼고 있습니다.
-모든 장단점들은 이 페이지에서 설명할 내용이 아니지만, 가장 기본적인
-이유는 대부분의 패키지 관리자들의 공식 저장소에는 오래된 버전의 루비가 있기
-때문입니다.
-최신의 루비를 사용하고자 한다면, 올바른 패키지 명을 사용했는지 확인하거나
-밑에 설명할 도구를 사용하십시오.
+말아야 하고, 대신 도구를 사용해야 한다고 느끼고 있습니다.
 
+대부분의 패키지 관리자들은 오래된 버전의 루비를 설치합니다.
+최신의 루비를 사용하고자 한다면, 패키지의 버전 번호가 올바른지 확인하거나
+특정 [인스톨러][installers]를 사용하세요.
 
 ### apt (Debian이나 Ubuntu)
 {: #apt}
@@ -114,16 +119,16 @@ Arch Linux는 pacman이라는 이름의 패키지 관리자를 사용합니다.
 $ sudo pacman -S ruby
 {% endhighlight %}
 
+이는 루비의 최신 안정판을 설치할 것입니다.
+
 
 ### Homebrew (macOS)
 {: #homebrew}
 
-macOS 엘 캐피탄, 요세미티, 매버릭스에는 루비 2.0이 포함되어 있습니다.
-macOS 마운틴 라이언, 라이언, 스노 레퍼드는 루비 1.8.7을
-탑재하여 출시되었습니다.
+엘 캐피탄(10.11)부터 모하비(10.14)까지의 macOS 릴리스에서는 루비 2.0 이상이 포함되어 있습니다.
 
-많은 macOS 사용자들은 패키지 관리자로 [Homebrew][homebrew]를 사용합니다.
-Homebrew를 사용해 새로운 버전의 루비를 얻는 방법은 정말로 쉽습니다.
+[Homebrew][homebrew]는 macOS에서 일반적으로 사용되는 패키지 관리자입니다.
+Homebrew를 사용해 새로운 버전의 루비를 설치하는 것은 쉽습니다.
 
 {% highlight sh %}
 $ brew install ruby
@@ -132,21 +137,37 @@ $ brew install ruby
 이 명령어는 최신 루비 버전을 설치할 것입니다.
 
 
+### FreeBSD
+{: #freebsd}
+
+FreeBSD는 패키지와 소스로부터 설치하는 방법을 모두 제공합니다.
+pkg를 이용하여 패키지를 설치할 수 있습니다:
+
+{% highlight sh %}
+$ pkg install ruby
+{% endhighlight %}
+
+[포트 컬렉션][freebsd-ports-collection]을 사용하여 루비를 소스로부터 설치
+할 수 있습니다. 이는 설치 설정을 변경하고 싶을 때 유용합니다.
+
+FreeBSD 상의 루비와 그 환경에 대해서 더 자세한 정보는
+[FreeBSD Ruby Project 웹사이트][freebsd-ruby]에서 얻을 수 있습니다.
+
+
 ### Solaris와 OpenIndiana에서의 루비
 {: #solaris}
 
 Solaris 8에서 Solaris 10까지 [Sunfreeware][sunfreeware]에서 루비 1.8.7을 사용 가능하며
 [Blastwave][blastwave]에서 루비 1.8.7을 사용 가능합니다.
 [Sunfreeware][sunfreeware]에서 루비 1.9.2p0을 사용 가능하지만, 이는 구 버전입니다.
-서드파티 도구를 사용하면 최신 버전의 루비를 얻을 수 있습니다.
 
 [OpenIndiana][openindiana]에서 루비를 설치하려면,
-[Image Packaging System (IPS)][opensolaris-pkg] 클라이언트를 사용해 주십시오.
-이것은 루비 1.9를 위한 OpenSolaris 네트워크 저장소로부터 최신
+Image Packaging System (IPS) 클라이언트를 사용해 주십시오.
+이것은 OpenSolaris 저장소로부터 최신
 루비 바이너리와 RubyGems를 직접 받아 설치합니다. 아주 쉽습니다.
 
 {% highlight sh %}
-$ pkg install runtime/ruby-18
+$ pkg install runtime/ruby
 {% endhighlight %}
 
 하지만, 서드파티 도구를 사용하는 것이 최신 버전의 루비를 얻는 더 좋은 방법입니다.
@@ -155,7 +176,7 @@ $ pkg install runtime/ruby-18
 ### 다른 배포판
 
 다른 시스템에서는 자신의 Linux 배포 관리자를 위한 패키지 저장소를 검색할 수 있습니다.
-아니면 서드파티 도구가 당신을 위한 올바른 선택일 수 있습니다.
+아니면 [서드파티 인스톨러][installers]를 사용할 수도 있습니다.
 
 
 ## 인스톨러
@@ -163,8 +184,10 @@ $ pkg install runtime/ruby-18
 
 시스템이나 패키지 관리자에서 제공하는 루비가 구 버전이라면, 서드 파티 인스톨러를
 사용해 새로운 버전의 루비를 설치할 수 있습니다.
+
 어떤 인스톨러는 여러 버전의 루비를 같은 시스템에 설치하게 합니다.
 관련된 관리자는 다른 루비 간의 전환을 도와줍니다.
+
 [RVM](#rvm)을 버전 관리자로 사용할 계획이라면 포함되어 있으므로 별도의 인스톨러는
 필요 없습니다.
 
@@ -182,17 +205,16 @@ macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 {: #ruby-install}
 
 [ruby-install][ruby-install]은 다른 버전의 루비를 임의의 디렉터리에
-컴파일하고 설치할 수 있게 합니다.
-루비 버전을 전환하는 [chruby](#chruby)와 형제 관계입니다.
+컴파일하고 설치할 수 있게 합니다. [chruby](#chruby)도 루비 버전을 변경하는
+좋은 도구입니다.
 macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 
 
 ### RubyInstaller
 {: #rubyinstaller}
 
-Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로젝트 [RubyInstaller][rubyinstaller]가
-있습니다. RubyInstaller는 Windows 환경에서 전체 루비 개발 환경을 설정하는데 필요한 모든
-것을 제공합니다.
+Windows에서는 [RubyInstaller][rubyinstaller]는 전체 루비 개발 환경을 설정하는데
+필요한 모든 것을 제공합니다.
 
 다운로드 받으시고 인스톨러를 실행하기만 하면 끝입니다!
 
@@ -202,18 +224,19 @@ Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로
 
 루비 온 레일즈를 사용하기 위해 루비를 설치하신다면 다음 인스톨러를 사용할 수 있습니다.
 
-* [RailsInstaller][railsinstaller]는 RubyInstaller를 사용하지만, 레일즈 개발을
-  도와줄 추가 도구들을 제공합니다.
-  OS X, Windows를 지원합니다.
+* [RailsInstaller][railsinstaller]는 [RubyInstaller][rubyinstaller]를
+  사용하지만, 레일즈 개발을 도와줄 추가 도구들을 제공합니다. macOS, Windows를
+  지원합니다.
 * [Bitnami Ruby Stack][rubystack]는 루비 온 레일즈를 위한 완전한 개발환경을 제공합니다.
-  macOS, Linux, Windows, 가상 기기, 클라우드 이미지를 지원합니다.
+  macOS, Linux, Windows, 가상 머신, 클라우드 이미지를 지원합니다.
 
 
 ## 관리자
 
 많은 루비스트들이 여러 버전의 루비를 관리하기 위해 루비 관리자를 사용합니다.
-그들은 다양한 장점을 부여하지만, 공식적으로 지원되는 것은 아닙니다.
-하지만, 그들 각각의 커뮤니티는 매우 유용합니다.
+그들은 각 프로젝트에서 서로 다른 루비 버전을 사용할 수 있도록 간단하게 또는
+자동으로 버전을 변경해주며 그 이외의 장점들이 있지만, 공식적으로 지원되는 것은 아닙니다.
+하지만, 각각의 커뮤니티에서 도움을 구할 수 있습니다.
 
 
 ### chruby
@@ -252,7 +275,7 @@ macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 {: #building-from-source}
 
 물론, 소스로부터 루비를 설치할 수도 있습니다.
-tarball을 [다운로드](/ko/downloads/), 압축을 풀고 이 명령어를 입력하세요.
+tarball을 [다운로드][download], 압축을 풀고 이 명령어를 입력하세요.
 
 {% highlight sh %}
 $ ./configure
@@ -263,6 +286,9 @@ $ sudo make install
 기본적으로, 이 명령어는 루비를 `/usr/local`에 설치합니다.
 변경하시려면 `./configure` 스크립트에 `--prefix=DIR` 옵션을 넘기세요.
 
+[루비 README 파일][readme]에서 소스로부터 루비를 설치하는 법에 관련된
+추가 정보를 얻을 수 있습니다.
+
 서드파티 도구나 패키지 관리자를 사용하시는 것이 더 좋습니다.
 왜냐하면, 이렇게 설치된 루비는 어떤 도구로도 관리되지 않기 때문이죠.
 
@@ -279,6 +305,11 @@ $ sudo make install
 [sunfreeware]: http://www.sunfreeware.com
 [blastwave]: http://www.blastwave.org
 [openindiana]: http://openindiana.org/
-[opensolaris-pkg]: http://opensolaris.org/os/project/pkg/
 [gentoo-ruby]: http://www.gentoo.org/proj/en/prog_lang/ruby/
+[freebsd-ruby]: https://wiki.freebsd.org/Ruby
+[freebsd-ports-collection]: https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html
 [homebrew]: http://brew.sh/
+[terminal]: : https://ko.wikipedia.org/wiki/%EB%8B%A8%EB%A7%90_%EC%97%90%EB%AE%AC%EB%A0%88%EC%9D%B4%ED%84%B0_%EB%AA%A9%EB%A1%9D
+[download]: /ko/downloads/
+[installers]: /ko/documentation/installation/#installers
+[readme]: https://github.com/ruby/ruby#how-to-compile-and-install