[KO] Follow up changes of #1877

Ref: #1877

Author: riseshia

ko/documentation/index.md

@@ -13,25 +13,11 @@ lang: ko
 
 ### 루비 설치하기
 
-브라우저에서만 루비를 시험해 보려는 게 아니라면 (밑의 링크 참조)
-컴퓨터에 루비를 설치할 필요가 있습니다.
-루비가 이미 설치되어 있는지 확인하려면 터미널을 열고 다음 명령어를
-입력하세요.
-
-{% highlight sh %}
-ruby -v
-{% endhighlight %}
-
-이 명령은 설치된 루비에 대한 정보를 알려줄 것입니다.
-설치되어 있지 않다면, [설치 페이지](installation/)에 있는 많은 옵션을
-참조하세요.
+[루비를 브라우저에서 시험해 볼 수도 있지만][1], 루비를 설치하기 위해서
+[설치 설명서](installation/)를 읽어보아도 좋습니다.
 
 ### 초보자용 문서
 
-[Try Ruby!][1] (영문)
-: 초보자를 위한 웹 기반의 대화형 튜토리얼입니다. 루비를 설치하지 않고도
-  브라우저만 있으면 루비를 배울 수 있습니다.
-
 [Ruby Koans][2] (영문)
 : Koans는 루비를 배우는 깨달음의 길로 여러분을 안내합니다. Koans의 목표는
   루비 언어, 문법, 구조, 일반적인 함수들과 라이브러리를 배우는 것입니다.
@@ -42,10 +28,6 @@ ruby -v
   책입니다. *Why the Lucky Stiff*의 저작물로 루비를 배우는 사람을 위한
   고전입니다.
 
-[루비 20분 가이드](/ko/documentation/quickstart/)
-: 루비의 기초를 다루는 튜토리얼입니다. 처음부터 끝까지 읽는 데 20분도 걸리지
-  않습니다.
-
 [Learning Ruby][6] (영문)
 : 새로 언어를 배우는 사람이나 루비의 개념과 구조를 검색하려는 사람들을 위한
   루비 스터디 노트들입니다.
@@ -68,10 +50,6 @@ ruby -v
 [루비 FAQ][ko-2]
 : 황대산 님이 정리하신 FAQ입니다.
 
-[다른 언어로 부터의 루비](/ko/documentation/ruby-from-other-languages/)
-: 다른 언어를 하시다 루비로 오셨나요? C, C++, Java, Perl, PHP, Python에
-  상관없이 이 글이면 충분합니다.
-
 ### 매뉴얼
 
 [프로그래밍 루비][9] (영문)
@@ -88,6 +66,9 @@ ruby -v
 
 ### 참조
 
+[공식 API 문서][40]
+: 아직 릴리스되지 않은 트렁크를 포함한 여러 루비 버전의 공식 API 문서입니다.
+
 [루비 코어 레퍼런스][13] (영문)
 : [RDoc][14]을 이용해 소스에서 추출한 레퍼런스입니다. String, Array,
   Symbol 등 모든 코어 클래스와 모듈에 대한 문서를 찾아볼 수 있습니다.
@@ -181,6 +162,7 @@ ruby -v
 [37]: http://www.sublimetext.com/
 [38]: http://ruby.learncodethehardway.org/
 [39]: http://kapeli.com/dash
+[40]: https://docs.ruby-lang.org/en/
 [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

ko/documentation/installation/index.md

@@ -4,12 +4,18 @@ title: "루비 설치하기"
 lang: ko
 ---
 
-루비를 설치할 때 몇 가지 도구를 사용할 수 있습니다.
-이 페이지에서는 루비를 설치하고 관리하는 주요 패키지
-관리 시스템들과 서드파티 도구들의 사용법과
-소스에서 루비를 빌드하는 법을 설명합니다.
+루비를 설치하고 관리할 수 있는 다양한 패키지 관리 시스템들과 서드파티 도구들이 있습니다.
+
 {: .summary}
 
+컴퓨터에 이미 루비가 설치되어 있을 수도 있습니다.
+이를 확인하려면 [터미널][terminal]을 열고 다음 명령어를 입력하세요.
+
+{% highlight sh %}
+ruby -v
+{% endhighlight %}
+
+이 명령은 설치된 루비에 대한 정보를 알려줄 것입니다.
 
 ## 설치 방법 선택하기
 
@@ -31,7 +37,7 @@ lang: ko
   * [CentOS, Fedora, RHEL](#yum)
   * [Gentoo](#portage)
   * [Arch Linux](#pacman)
-  * [OS X](#homebrew)
+  * [macOS](#homebrew)
   * [Solaris, OpenIndiana](#solaris)
   * [다른 배포판](#other-systems)
 * [인스톨러](#installers)
@@ -54,13 +60,11 @@ lang: ko
 루비를 설치하기 위해 자신의 시스템의 패키지 관리자를 사용할 수 있습니다.
 
 루비 커뮤니티의 일부 회원들은 루비를 설치할 때 패키지 관리자를 사용하지
-말아야 하고, 대신 도구를 사용해야 한다고 강하게 느끼고 있습니다.
-모든 장단점들은 이 페이지에서 설명할 내용이 아니지만, 가장 기본적인
-이유는 대부분의 패키지 관리자들의 공식 저장소에는 오래된 버전의 루비가 있기
-때문입니다.
-최신의 루비를 사용하고자 한다면, 올바른 패키지 명을 사용했는지 확인하거나
-밑에 설명할 도구를 사용하십시오.
+말아야 하고, 대신 도구를 사용해야 한다고 느끼고 있습니다.
 
+대부분의 패키지 관리자들은 오래된 버전의 루비를 설치합니다.
+최신의 루비를 사용하고자 한다면, 패키지의 버전 번호가 올바른지 확인하거나
+특정 [인스톨러][installers]를 사용하세요.
 
 ### apt (Debian이나 Ubuntu)
 {: #apt}
@@ -115,15 +119,13 @@ $ sudo pacman -S ruby
 {% endhighlight %}
 
 
-### Homebrew (OS X)
+### Homebrew (macOS)
 {: #homebrew}
 
-OS X 엘 캐피탄, 요세미티, 매버릭스에는 루비 2.0이 포함되어 있습니다.
-OS X 마운틴 라이언, 라이언, 스노 레퍼드는 루비 1.8.7을
-탑재하여 출시되었습니다.
+엘 캐피탄(10.11)부터 모하브(10.14)까지의 macOS 릴리스에서는 루비 2.0 이상이 포함되어 있습니다.
 
-많은 OS X 사용자들은 패키지 관리자로 [Homebrew][homebrew]를 사용합니다.
-Homebrew를 사용해 새로운 버전의 루비를 얻는 방법은 정말로 쉽습니다.
+[Homebrew][homebrew]는 macOS에서 일반적으로 사용되는 패키지 관리자입니다.
+Homebrew를 사용해 새로운 버전의 루비를 설치하는 것은 쉽습니다.
 
 {% highlight sh %}
 $ brew install ruby
@@ -155,16 +157,18 @@ $ pkg install runtime/ruby-18
 ### 다른 배포판
 
 다른 시스템에서는 자신의 Linux 배포 관리자를 위한 패키지 저장소를 검색할 수 있습니다.
-아니면 서드파티 도구가 당신을 위한 올바른 선택일 수 있습니다.
+아니면 [서드파티 인스톨러][installers]를 사용할 수도 있습니다.
 
 
 ## 인스톨러
 {: #installers}
 
 시스템이나 패키지 관리자에서 제공하는 루비가 구 버전이라면, 서드 파티 인스톨러를
 사용해 새로운 버전의 루비를 설치할 수 있습니다.
+
 어떤 인스톨러는 여러 버전의 루비를 같은 시스템에 설치하게 합니다.
 관련된 관리자는 다른 루비 간의 전환을 도와줍니다.
+
 [RVM](#rvm)을 버전 관리자로 사용할 계획이라면 포함되어 있으므로 별도의 인스톨러는
 필요 없습니다.
 
@@ -175,24 +179,23 @@ $ pkg install runtime/ruby-18
 [ruby-build][ruby-build]는 다른 버전의 루비를 임의의 디렉터리에
 컴파일하고 설치할 수 있게 하는 [rbenv](#rbenv)의 플러그인입니다.
 ruby-build는 rbenv 없이 독자적으로 사용 할 수도 있습니다.
-맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
+macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 
 
 ### ruby-install
 {: #ruby-install}
 
 [ruby-install][ruby-install]은 다른 버전의 루비를 임의의 디렉터리에
-컴파일하고 설치할 수 있게 합니다.
-루비 버전을 전환하는 [chruby](#chruby)와 형제 관계입니다.
-맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
+컴파일하고 설치할 수 있게 합니다. [chruby](#chruby)도 루비 버전을 변경하는
+좋은 도구입니다.
+macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 
 
 ### RubyInstaller
 {: #rubyinstaller}
 
-Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로젝트 [RubyInstaller][rubyinstaller]가
-있습니다. RubyInstaller는 Windows 환경에서 전체 루비 개발 환경을 설정하는데 필요한 모든
-것을 제공합니다.
+Windows에서는 [RubyInstaller][rubyinstaller]는 전체 루비 개발 환경을 설정하는데
+필요한 모든 것을 제공합니다.
 
 다운로드 받으시고 인스톨러를 실행하기만 하면 끝입니다!
 
@@ -202,18 +205,19 @@ Windows를 사용하고 있다면, 루비 설치를 도와줄 훌륭한 프로
 
 루비 온 레일즈를 사용하기 위해 루비를 설치하신다면 다음 인스톨러를 사용할 수 있습니다.
 
-* [RailsInstaller][railsinstaller]는 RubyInstaller를 사용하지만, 레일즈 개발을
-  도와줄 추가 도구들을 제공합니다.
-  OS X, Windows를 지원합니다.
+* [RailsInstaller][railsinstaller]는 [RubyInstaller][rubyinstaller]를
+  사용하지만, 레일즈 개발을 도와줄 추가 도구들을 제공합니다. macOS, Windows를
+  지원합니다.
 * [Bitnami Ruby Stack][rubystack]는 루비 온 레일즈를 위한 완전한 개발환경을 제공합니다.
-  OS X, Linux, Windows, 가상 기기, 클라우드 이미지를 지원합니다.
+  macOS, Linux, Windows, 가상 기기, 클라우드 이미지를 지원합니다.
 
 
 ## 관리자
 
 많은 루비스트들이 여러 버전의 루비를 관리하기 위해 루비 관리자를 사용합니다.
-그들은 다양한 장점을 부여하지만, 공식적으로 지원되는 것은 아닙니다.
-하지만, 그들 각각의 커뮤니티는 매우 유용합니다.
+그들은 각 프로젝트에서 서로 다른 루비 버전을 사용할 수 있도록 간단하게 또는
+자동으로 버전을 변경해주며 그 이외의 장점들이 있지만, 공식적으로 지원되는 것은 아닙니다.
+하지만, 각각의 커뮤니티에서 도움을 구할 수 있습니다.
 
 
 ### chruby
@@ -230,29 +234,29 @@ chruby는 [ruby-install](#ruby-install)로 설치된 루비뿐만
 [rbenv][rbenv]는 여러 종류의 루비를 설치할 수 있게 합니다.
 rbenv 자체는 루비 설치를 지원하지 않습니다만, [ruby-build](#ruby-build)라는
 유명한 플러그인에서 루비를 설치할 수 있습니다.
-rbenv, ruby-build 모두 맥 OS X, Linux나 다른 UNIX-계열 운영체제에서 사용가능합니다.
+rbenv, ruby-build 모두 macOS, Linux나 다른 UNIX-계열 운영체제에서 사용가능합니다.
 
 
 ### RVM ("Ruby Version Manager")
 {: #rvm}
 
 [RVM][rvm]은 시스템에 여러 종류의 루비를 설치하고 관리할 수 있게 해줍니다.
 RVM은 다른 gemsets도 관리해 줍니다.
-맥 OS X, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
+macOS, Linux나 다른 UNIX-계열 운영체제에서만 사용 가능합니다.
 
 
 ### uru
 {: #uru}
 
-[Uru][uru]는 OS X, Linux, Windows에서 여러 루비를 사용하게 하는 가벼운
+[Uru][uru]는 macOS, Linux, Windows에서 여러 루비를 사용하게 하는 가벼운
 멀티 플랫폼 커맨드 라인 툴입니다.
 
 
 ## 소스에서 빌드하기
 {: #building-from-source}
 
 물론, 소스로부터 루비를 설치할 수도 있습니다.
-tarball을 [다운로드](/ko/downloads/), 압축을 풀고 이 명령어를 입력하세요.
+tarball을 [다운로드][download], 압축을 풀고 이 명령어를 입력하세요.
 
 {% highlight sh %}
 $ ./configure
@@ -263,6 +267,9 @@ $ sudo make install
 기본적으로, 이 명령어는 루비를 `/usr/local`에 설치합니다.
 변경하시려면 `./configure` 스크립트에 `--prefix=DIR` 옵션을 넘기세요.
 
+[루비 README 파일][readme]에서 소스로부터 루비를 설치하는 법에 관련된
+추가 정보를 얻을 수 있습니다.
+
 서드파티 도구나 패키지 관리자를 사용하시는 것이 더 좋습니다.
 왜냐하면, 이렇게 설치된 루비는 어떤 도구로도 관리되지 않기 때문이죠.
 
@@ -282,3 +289,7 @@ $ sudo make install
 [opensolaris-pkg]: http://opensolaris.org/os/project/pkg/
 [gentoo-ruby]: http://www.gentoo.org/proj/en/prog_lang/ruby/
 [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]: /en/documentation/installation/#installers
+[readme]: https://github.com/ruby/ruby#how-to-compile-and-install