Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove links to 3rd-party tools with Privacy issues. #2270

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 1 addition & 36 deletions locale/en/docs/guides/debugging-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,38 +77,10 @@ info on these follows:
* The latest version can also be installed independently (e.g. `npm install -g node-inspect`)
and used with `node-inspect myscript.js`.

#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just a link to a mirror from the Chromium repo which is what's being tested against the Node inspector. If we remove this we need another alternative "blessed" frontend and to run tests against it.

I think we should keep this in the docs for now since the two interconnected parts (v8 and the devtools frontend) are part of the same open source project (chromium) and v8 is a hard dependency of Node.

As an alternative - we might want to ship this.


* **Option 1**: Open `chrome://inspect` in a Chromium-based
browser. Click the Configure button and ensure your target host and port
are listed.
* **Option 2**: Copy the `devtoolsFrontendUrl` from the output of `/json/list`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can be edited to recommend Chromium based and not Chrome though.

(see above) or the --inspect hint text and paste into Chrome.

#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree it is not our place to recommend these tools so +1 on removing them.

Copy link

@thom4parisot thom4parisot Jun 19, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As an alternative, VSCodium is VSCode without the trackers.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes though why is it our place to recommend an IDE anyway?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know, but I thought the scope was about third-party privacy issues, not about not recommending tools.


* In the Debug panel, click the settings icon to open `.vscode/launch.json`.
Select "Node.js" for initial setup.

#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* Choose "Debug > Start Debugging" from the menu or hit F5.
* [Detailed instructions](https://github.com/Microsoft/nodejstools/wiki/Debugging).

#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ and other JetBrains IDEs

* Create a new Node.js debug configuration and hit Debug. `--inspect` will be used
by default for Node.js 7+. To disable uncheck `js.debugger.node.use.inspect` in
the IDE Registry.

#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Library to ease connections to Inspector Protocol endpoints.

#### [Gitpod](https://www.gitpod.io)

* Start a Node.js debug configuration from the `Debug` view or hit `F5`. [Detailed instructions](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---

## Command-line options
Expand Down Expand Up @@ -205,8 +177,7 @@ $ ssh -L 9221:localhost:9229 [email protected]

This starts a ssh tunnel session where a connection to port 9221 on your local
machine will be forwarded to port 9229 on remote.example.com. You can now attach
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would keep DevTools and remove Visual Studio Code here

which should be able to debug as if the Node.js application was running locally.
a debugger to localhost:9221, which should be able to debug as if the Node.js application was running locally.

---

Expand All @@ -230,12 +201,6 @@ command-line debugger. Your script starts in another Node process started with
the `--debug-brk` option, and the initial Node process runs the `_debugger.js`
script and connects to your target.

#### [node-inspector](https://github.com/node-inspector/node-inspector)

Debug your Node.js app with Chrome DevTools by using an intermediary process
which translates the Inspector Protocol used in Chromium to the V8 Debugger
protocol used in Node.js.

<!-- refs -->

[Inspector Protocol]: https://chromedevtools.github.io/debugger-protocol-viewer/v8/
Expand Down
36 changes: 1 addition & 35 deletions locale/fa/docs/guides/debugging-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,38 +77,10 @@ info on these follows:
* The latest version can also be installed independently (e.g. `npm install -g node-inspect`)
and used with `node-inspect myscript.js`.

#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+

* **Option 1**: Open `chrome://inspect` in a Chromium-based
browser. Click the Configure button and ensure your target host and port
are listed.
* **Option 2**: Copy the `devtoolsFrontendUrl` from the output of `/json/list`
(see above) or the --inspect hint text and paste into Chrome.

#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* In the Debug panel, click the settings icon to open `.vscode/launch.json`.
Select "Node.js" for initial setup.

#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* Choose "Debug > Start Debugging" from the menu or hit F5.
* [Detailed instructions](https://github.com/Microsoft/nodejstools/wiki/Debugging).

#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ and other JetBrains IDEs

* Create a new Node.js debug configuration and hit Debug. `--inspect` will be used
by default for Node.js 7+. To disable uncheck `js.debugger.node.use.inspect` in
the IDE Registry.

#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Library to ease connections to Inspector Protocol endpoints.

#### [Gitpod](https://www.gitpod.io)

* Start a Node.js debug configuration from the `Debug` view or hit `F5`. [Detailed instructions](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---

## Command-line options
Expand Down Expand Up @@ -205,7 +177,7 @@ $ ssh -L 9221:localhost:9229 [email protected]

This starts a ssh tunnel session where a connection to port 9221 on your local
machine will be forwarded to port 9229 on remote.example.com. You can now attach
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
a debugger to localhost:9221,
which should be able to debug as if the Node.js application was running locally.

---
Expand All @@ -230,12 +202,6 @@ command-line debugger. Your script starts in another Node process started with
the `--debug-brk` option, and the initial Node process runs the `_debugger.js`
script and connects to your target.

#### [node-inspector](https://github.com/node-inspector/node-inspector)

Debug your Node.js app with Chrome DevTools by using an intermediary process
which translates the Inspector Protocol used in Chromium to the V8 Debugger
protocol used in Node.js.

<!-- refs -->

[Inspector Protocol]: https://chromedevtools.github.io/debugger-protocol-viewer/v8/
Expand Down
32 changes: 1 addition & 31 deletions locale/it/docs/guides/debugging-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,30 +99,6 @@ info on these follows:
* The latest version can also be installed independently (e.g. `npm install -g node-inspect`)
and used with `node-inspect myscript.js`.

#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+

* **Option 1**: Open `chrome://inspect` in a Chromium-based
browser. Click the Configure button and ensure your target host and port
are listed.
* **Option 2**: Copy the `devtoolsFrontendUrl` from the output of `/json/list`
(see above) or the --inspect hint text and paste into Chrome.

#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* In the Debug panel, click the settings icon to open `.vscode/launch.json`.
Select "Node.js" for initial setup.

#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* Choose "Debug > Start Debugging" from the menu or hit F5.
* [Detailed instructions](https://github.com/Microsoft/nodejstools/wiki/Debugging).

#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ and other JetBrains IDEs

* Create a new Node.js debug configuration and hit Debug. `--inspect` will be used
by default for Node.js 7+. To disable uncheck `js.debugger.node.use.inspect` in
the IDE Registry.

#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Library to ease connections to Inspector Protocol endpoints.
Expand Down Expand Up @@ -223,7 +199,7 @@ $ ssh -L 9221:localhost:9229 [email protected]

This starts a ssh tunnel session where a connection to port 9221 on your local
machine will be forwarded to port 9229 on remote.example.com. You can now attach
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
a debugger to localhost:9221,
which should be able to debug as if the Node.js application was running locally.

---
Expand All @@ -248,12 +224,6 @@ command-line debugger. Your script starts in another Node process started with
the `--debug-brk` option, and the initial Node process runs the `_debugger.js`
script and connects to your target.

#### [node-inspector](https://github.com/node-inspector/node-inspector)

Debug your Node.js app with Chrome DevTools by using an intermediary process
which translates the Inspector Protocol used in Chromium to the V8 Debugger
protocol used in Node.js.

<!-- refs -->

[Inspector Protocol]: https://chromedevtools.github.io/debugger-protocol-viewer/v8/
Expand Down
84 changes: 1 addition & 83 deletions locale/ja/docs/guides/debugging-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,78 +166,10 @@ info on these follows:
* バージョンは Node にバンドルされており、`node inspect myscript.js`と一緒に使うことができます
* 最新バージョンは独立してインストールすることもでき (例えば `npm install -g node-inspect`)、 `node-inspect myscript.js` と一緒に使うことができます

<!--
#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+

* **Option 1**: Open `chrome://inspect` in a Chromium-based
browser. Click the Configure button and ensure your target host and port
are listed.
* **Option 2**: Copy the `devtoolsFrontendUrl` from the output of `/json/list`
(see above) or the --inspect hint text and paste into Chrome.

-->
#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+

* **オプション 1**: Chromium ベースのブラウザで `chrome://inspect` を開きます。設定ボタンをクリックして、ターゲットホストとポートが表示されていることを確認します。
* **オプション 2**: `/json/list`の出力 (上記を参照) または --inspect ヒントテキストから `devtoolsFrontendUrl` をコピーして Chrome に貼り付けます

<!--
#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* In the Debug panel, click the settings icon to open `.vscode/launch.json`.
Select "Node.js" for initial setup.

-->
#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* デバッグパネルで、設定アイコンをクリックして `.vscode/launch.json` を開きます。初期設定は "Node.js" を選択してください

<!--
#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* Choose "Debug > Start Debugging" from the menu or hit F5.
* [Detailed instructions](https://github.com/Microsoft/nodejstools/wiki/Debugging).

-->
#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* メニューから "デバッグ > デバッグの開始" を選択するか、F5 を押します
* [詳しい説明](https://github.com/Microsoft/nodejstools/wiki/Debugging)

<!--
#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ and other JetBrains IDEs

* Create a new Node.js debug configuration and hit Debug. `--inspect` will be used
by default for Node.js 7+. To disable uncheck `js.debugger.node.use.inspect` in
the IDE Registry.

-->
#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ と他の JetBrains IDE

* 新しい Node.js デバッグ設定を作成して Debug をクリックします。Node.js 7 以降の場合、`--inspect` がデフォルトで使用されます。IDE レジストリで `js.debugger.node.use.inspect` のチェックを外します

<!--
#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Library to ease connections to Inspector Protocol endpoints.

-->
#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Inspector Protocol エンドポイントへの接続を容易にするためのライブラリ

<!--
#### [Gitpod](https://www.gitpod.io)

* Start a Node.js debug configuration from the `Debug` view or hit `F5`. [Detailed instructions](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---

-->
#### [Gitpod](https://www.gitpod.io)

* `Debug` ビュー から Node.js デバッグ設定を開始するか、`F5` を押します。[詳しい説明](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---

<!--
Expand Down Expand Up @@ -404,7 +336,7 @@ $ ssh -L 9221:localhost:9229 [email protected]

This starts a ssh tunnel session where a connection to port 9221 on your local
machine will be forwarded to port 9229 on remote.example.com. You can now attach
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
a debugger to localhost:9221,
which should be able to debug as if the Node.js application was running locally.

---
Expand Down Expand Up @@ -485,20 +417,6 @@ Node の組み込みコマンドラインデバッガの下でスクリプトを
スクリプトは `--debug-brk` オプションで開始された別のノードプロセスで開始され、
最初のノードプロセスは `_debugger.js` スクリプトを実行してターゲットに接続します。

<!--
#### [node-inspector](https://github.com/node-inspector/node-inspector)

Debug your Node.js app with Chrome DevTools by using an intermediary process
which translates the Inspector Protocol used in Chromium to the V8 Debugger
protocol used in Node.js.

-->
#### [node-inspector](https://github.com/node-inspector/node-inspector)

Chromium で使用されるインスペクタプロトコルを
Node.js で使用される V8 デバッガプロトコルに変換する中間プロセスを使用して、
Chrome DevTools で Node.js アプリケーションをデバッグします。

<!-- refs -->

<!--
Expand Down
71 changes: 2 additions & 69 deletions locale/ko/docs/guides/debugging-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,66 +144,10 @@ Node 인스펙터에 접속할 수 있는 여러 상용 도구와 오픈소스
* 최신 버전을 별도로 설치할 수 있고(예시: `npm install -g node-inspect`)
`node-inspect myscript.js`로 사용할 수 있습니다.

#### [Chrome DevTools](https://github.com/ChromeDevTools/devtools-frontend) 55+

* **방법 1**: 크로미움에 기반을 둔 브라우저에서 `chrome://inspect`를 엽니다.
Configure 버튼을 눌러서 대상 호스트와 포트 목록을 확인합니다.
* **방법 2**: `/json/list`(상단 참고)의 출력에서 `devtoolsFrontendUrl`을
복사하거나 --inspect가 알려준 텍스트에서 복사해서 크롬에 붙여넣기를 합니다.

<!--
#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* In the Debug panel, click the settings icon to open `.vscode/launch.json`.
Select "Node.js" for initial setup.

#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* Choose "Debug > Start Debugging" from the menu or hit F5.
* [Detailed instructions](https://github.com/Microsoft/nodejstools/wiki/Debugging).

#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+ and other JetBrains IDEs

* Create a new Node.js debug configuration and hit Debug. `--inspect` will be used
by default for Node.js 7+. To disable uncheck `js.debugger.node.use.inspect` in
the IDE Registry.

#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* Library to ease connections to Inspector Protocol endpoints.

#### [Gitpod](https://www.gitpod.io)

* Start a Node.js debug configuration from the `Debug` view or hit `F5`. [Detailed instructions](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---
-->

#### [Visual Studio Code](https://github.com/microsoft/vscode) 1.10+

* Debug 패널에서 설정 아이콘을 클릭해서 `.vscode/launch.json`을 엽니다.
초기 설정으로 "Node.js"를 선택하세요.

#### [Visual Studio](https://github.com/Microsoft/nodejstools) 2017

* 메뉴에서 "Debug > Start Debugging"을 선택하거나 F5를 누르세요.
* [상세한 설명](https://github.com/Microsoft/nodejstools/wiki/Debugging)

#### [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) 2017.1+와 다른 JetBrains IDE

* 새로운 Node.js 디버그 설정을 생성하고 Debug를 누르세요. Node.js 7+에서는
기본적으로 `--inspect`를 사용할 것입니다. 비활성화하려면 IDE 레지스트리에서
`js.debugger.node.use.inspect`의 체크를 해제하세요.

#### [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface)

* 인스펙터 프로토콜 엔드포인트로의 연결을 쉽게 하는 라이브러리입니다.

#### [Gitpod](https://www.gitpod.io)

* `Debug` 뷰에서 Node.js 디버그 설정을 실행하거나 `F5` 키를 누르세요.
[자세한 방법은 여기를 참고하세요.](https://medium.com/gitpod/debugging-node-js-applications-in-theia-76c94c76f0a1)

---

<!--
Expand Down Expand Up @@ -380,10 +324,10 @@ $ ssh -L 9221:localhost:9229 [email protected]
<!--
This starts a ssh tunnel session where a connection to port 9221 on your local
machine will be forwarded to port 9229 on remote.example.com. You can now attach
a debugger such as Chrome DevTools or Visual Studio Code to localhost:9221,
a debugger to localhost:9221,
which should be able to debug as if the Node.js application was running locally.
-->
그러면 로컬 시스템의 9221 포트에서 remote.example.com의 9229 포트로 전달되는 ssh 터널 세션이 시작됩니다. Chrome DevTools 또는 Visual Studio Code 등의 디버거로 localhost:9221에 연결 할 수 있으며 Node.js 애플리케이션이 로컬에서 실행 중인 것처럼 디버깅할 수 있습니다.
그러면 로컬 시스템의 9221 포트에서 remote.example.com의 9229 포트로 전달되는 ssh 터널 세션이 시작됩니다. 등의 디버거로 localhost:9221에 연결 할 수 있으며 Node.js 애플리케이션이 로컬에서 실행 중인 것처럼 디버깅할 수 있습니다.

---

Expand Down Expand Up @@ -420,12 +364,6 @@ Start `node debug script_name.js` to start your script under Node's builtin
command-line debugger. Your script starts in another Node process started with
the `--debug-brk` option, and the initial Node process runs the `_debugger.js`
script and connects to your target.

#### [node-inspector](https://github.com/node-inspector/node-inspector)

Debug your Node.js app with Chrome DevTools by using an intermediary process
which translates the Inspector Protocol used in Chromium to the V8 Debugger
protocol used in Node.js.
-->

#### [내장 디버거](https://nodejs.org/dist/latest-v6.x/docs/api/debugger.html)
Expand All @@ -434,11 +372,6 @@ Node의 내장 명령형 디버거로 스크립트를 실행하려면 `node debu
스크립트가 다른 Node 프로세스에서 `--debug-brk` 옵션으로 시작되고 원래의 Node 프로세스는
`_debugger.js`를 실행해서 대상에 접속합니다.

#### [node-inspector](https://github.com/node-inspector/node-inspector)

크로미움에서 사용하는 인스펙터 프로토콜을 Node.js가 사용하는 V8 디버거 프로토콜로 변환하는
중간 프로세스를 사용해서 크롬 개발자도구로 Node.js 애플리케이션을 디버깅합니다.

<!-- refs -->

<!--
Expand Down
Loading