Use polite expressions, Omit 'you'

Author: marocchino

doc/guide/ko/authentication.md

@@ -2,19 +2,19 @@
 # 인증
 
 <!--Users can be authenticated in two ways: over the websocket or over HTTP.-->
-사용자들은 두가지 방법으로 인증되어 질 수 있다: 웹소켓으로 또는 HTTP를 통해.
+인증은 웹소켓이나 HTTP으로 할수 있습니다.
 
 <!--The first option is useful if you're authenticating against a backend database or other resource you control, the second if you're using a third-party service such as Facebook Connect.-->
-백-앤드 데이터베이스 또는 제어하는 다른 리소스에 인증하고 있다면첫번째 방법이 유용하고 Facebook Connect같은 그런 서드파티 서비스를 이용하고 있다면 두번째 방법이 유용하다.
+첫번째 방법은 직접 관리하시는 데이터베이스나 리소스에 인증하고 있을때  유용하고, 두번째 방법은 페이스북같은 외부 인증을 사용할때 유용합니다.
 
 <!--Either way, the goal is the same: to update `req.session.userId` with the user's unique ID.-->
-어느 경우라도, 목표는 같다: `req.session.userId`를 사용자의 유니크 ID로 변경하기
+어떤 방법이든 '`req.session.userId`에 사용자 고유의 ID를 넣고 싶다.'라는 목표는 같습니다.
 
 <!---### Authenticating over websockets-->
 ### 웹소켓을 통한 인증
 
 <!--This is the best choice if you're authenticating against an internal database or LDAP server, etc.-->
-내부의 데이터베이스 또는 LDAP서버 등 에 인증하고 있다면 이것이(웹소켓이) 최고의 선택이다.
+내부의 데이터베이스 또는 LDAP서버 등 에 인증하고 있다면 이것이(웹소켓이) 최고의 선택일 거에요.
 
 ```javascript
 // server/rpc/app.js
@@ -45,30 +45,29 @@ exports.actions = function(req, res, ss){
       // lookup user in DB, LDAP, etc
 -->
 <!--Note: You could just set`req.session.userId` manually, but calling the `req.session.setUserId()` function saves the session and notifies SocketStream to immediately start sending events for this user (sent using `ss.publish.user()`) over the current websocket connection.-->
-Note: 당신이 `req.session.userId`을 그냥 수동적으로 바꿀 수 있다. 그러나 호출한 `req.session.setUserId()` 함수는 세션을 저장하고 SocketStream에게 즉시 (`ss.publish.user()`를 사용하여 전송)이 사용자에게 이벤트 전송을 시작을 알린다.
+주의: 당신이 `req.session.userId`을 그냥 수동으로 바꿀 수도 있지만, 그렇게 하기보단 `req.session.setUserId()`를 호출해 세션을 저장하고 현재의 웹소켓 연결을 사용하여 SocketStream에게 이 유저의(`ss.publish.user()`를 사용하여 전송) 이벤트 전송이 시작됬음을 알리는게 좋습니다.
 
 <!---### Authenticating using HTTP-->
-### HTTP이용 인증
+### HTTP이용한 인증
 
-<!--Since the same session object is also available over HTTP you may easily authenticate a user by updating `req.session.userId`-->
-whilst processing a HTTP request.
-같은 세션 객체는 HTTP를 통하여도 가능하기 때문에 HTTP Request를 처리하는 동안 `req.session.userId`을 변경하여 인증할 수 있다.
+<!--Since the same session object is also available over HTTP you may easily authenticate a user by updating `req.session.userId` whilst processing a HTTP request.-->
+같은 세션 객체는 HTTP를 통하여도 가능하기 때문에 HTTP Request를 처리하는 동안 `req.session.userId`을 변경하여 인증할 수 있습니다.
 
 <!--Let's look at a very simple example by adding the following 'route' to `app.js`:-->
-다음에 나오는 'route'를 `app.js`에 추가한 매우 쉬운 예제를 보자:
+다음에 나오는 'route'를 `app.js`에 추가한 매우 쉬운 예제를 봅시다:
 
 ```javascript
 // app.js
 ss.http.router.on('/authenticateMe', function(req, res) {
-  req.session.userId = 'john';
+  req.session.userId = '나솔';
   req.session.save(function(err){
     res.serve('main');
   });
 });
 ```
 
 <!--Next, add an RPC action which sends the contents of `req.session.userId` over the websocket:-->
-다음으로 웹소켓을 통해 `req.session.userId`의 컨텐츠들를 전송하는 작업을 하는 RPC를 추가한다.
+다음으로 웹소켓을 통해 `req.session.userId`의 컨텐츠들를 전송하는 RPC를 추가합니다.
 
 ```javascript
 // server/rpc/app.js
@@ -80,7 +79,7 @@ exports.actions = function(req, res, ss){
   return {
 
     getCurrentUser: function(){
-      res('The current user is ' + req.session.userId);
+      res('현재 사용자는 ' + req.session.userId + '님 입니다.');
     }
 
   }
@@ -89,33 +88,32 @@ exports.actions = function(req, res, ss){
 <!---// tell SocketStream to load session data-->
 
 <!--Now visit `http://localhost:3000/authenticateMe` then enter the following command in the browser's console:-->
-이제 `http://localhost:3000/authenticateMe` 방문하라 그리고 브라우저 콘솔에 다음 내용을 입력하라:
+이제 `http://localhost:3000/authenticateMe` 가서 브라우저 콘솔에 다음 명령을 실행해보세요:
 
     ss.rpc('app.getCurrentUser')
 
 <!--And you'll see the following output:-->
-그러면 당신은 다음과 같은 결과를 볼 것이다.:
-
-    The current user is john
+그러면 다음 결과가 출력 됩니다:
 
+    현재 사용자는 나솔님 입니다.
 
 <!---### Using Everyauth for Facebook Connect, Twitter, Github etc-->
 ### Facebook Connect, Twitter, Github 등의 위한 Everyauth 사용
 
 <!--SocketStream integrates well with popular authentication libraries such as [Everyauth](https://github.com/bnoguchi/everyauth).-->
-SocketStream은 [Everyauth](https://github.com/bnoguchi/everyauth)같은 유명한 인증 라이브러리들과 잘 통합된다.
+SocketStream은 [Everyauth](https://github.com/bnoguchi/everyauth)같은 널리쓰이는 인증 라이브러리들과 잘 통합됩니다.
 
 <!--Tip: Don't be tempted to follow the docs on the Everyauth website too closely - they are mainly geared at multi-page apps and/or specific to Express.-->
-팁: Everyauth 웹사이트의 문서를 너무 자세히 따르지 마라 - 그것들은 주로 멀티페이지 앱에 연관되거나/또는 Express를 명시하고 있다.
+팁: Everyauth 웹사이트의 문서를 너무 자세히 따르지 마세요 - 그것들은 주로 여러페이지를 가진 어플리케이션에 적합한 내용이거나 Express를 위한 겁니다.
 
 <!--Here's an example of a full app which authenticates against Twitter's OAuth service.-->
-여기 트위터의 oAuth서비스에 대한 인증을 하는 전체 app의 예제가 있다.
+트위터의 oAuth서비스에 대한 인증을 하는 전체 app의 예제입니다.
 
 <!--To get started, register your new app at https://dev.twitter.com/apps/new-->
-시작할때 https://dev.twitter.com/apps/new 에서 당신의 새 앱을 등록하라.
+시작하기전에 https://dev.twitter.com/apps/new 에서 당신의 새 앱을 등록하세요.
 
 <!--When testing your app supply `http://127.0.0.1:3000` as the Callback URL. Change this to the real URL when your app goes into production.-->
-당신의 앱을 테스트 할때 콜백 URL로 `http://127.0.0.1:3000`이 제공된다. 당신을 앱을 제품으로 만들때 할때 이것을 실제 URL로 변경하라.
+당신의 앱을 테스트 할때 콜백 URL로 `http://127.0.0.1:3000`이 제공됩니다. 당신을 앱을 제품으로 만들때 할때 이것을 실제 URL로 변경해야 합니다.
 
 ```javascript
 // app.js
@@ -134,11 +132,11 @@ ss.http.router.on('/', function(req, res) {
 });
 
 everyauth.twitter
-  .consumerKey('YOUR CONSUMER ID HERE')
-  .consumerSecret('YOUR CONSUMER SECRET HERE')
+  .consumerKey('여기에 CONSUMER ID 를 입력')
+  .consumerSecret('여기에 CONSUMER SECRET 를 입력')
   .findOrCreateUser( function (session, accessToken, accessTokenSecret, twitterUserMetadata) {
     var userName = twitterUserMetadata.screen_name;
-    console.log('Twitter Username is', userName);
+    console.log('트위터 유저이름: ', userName);
     session.userId = userName;
     session.save();
     return true;
@@ -153,9 +151,9 @@ server.listen(3000);
 
 ss.start(server);
 
-// 인증을 위해 http://local.host:3000/auth/twitter 방문
+// http://local.host:3000/auth/twitter 에서 인증해볼수 있습니다.
 ```
 <!--// To authenticate visit http://local.host:3000/auth/twitter-->
 
 <!--Many more details on this and other examples coming soon.-->
-이것에 대한 많고 더 상세함 과 다른 예제들이 곧 옵니다.
+인증에 대한 더 상세한 설명과 예제들이 곧 나올꺼에요.