Skip to content

Commit fd5f5ae

Browse files
author
Katie Horne
committed
Lint
1 parent d20519f commit fd5f5ae

File tree

8 files changed

+123
-151
lines changed

8 files changed

+123
-151
lines changed

docs/CONTRIBUTING.md

+14-16
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,19 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# Contributing
44

5-
- [Contributing](#contributing)
6-
- [Requirements](#requirements)
7-
- [Creating pull requests](#creating-pull-requests)
8-
- [Commits and commit history](#commits-and-commit-history)
9-
- [Development workflow](#development-workflow)
10-
- [Update VS Code](#update-vs-code)
11-
- [Build](#build)
12-
- [Test](#test)
13-
- [Unit tests](#unit-tests)
14-
- [Integration Tests](#integration-tests)
15-
- [End-to-end tests](#end-to-end-tests)
16-
- [Structure](#structure)
17-
- [Modifying VS Code](#modifying-vs-code)
18-
- [Currently Known Issues](#currently-known-issues)
5+
- [Requirements](#requirements)
6+
- [Creating pull requests](#creating-pull-requests)
7+
- [Commits and commit history](#commits-and-commit-history)
8+
- [Development workflow](#development-workflow)
9+
- [Update VS Code](#update-vs-code)
10+
- [Build](#build)
11+
- [Test](#test)
12+
- [Unit tests](#unit-tests)
13+
- [Integration Tests](#integration-tests)
14+
- [End-to-end tests](#end-to-end-tests)
15+
- [Structure](#structure)
16+
- [Modifying VS Code](#modifying-vs-code)
17+
- [Currently Known Issues](#currently-known-issues)
1918

2019
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
2120

@@ -75,8 +74,7 @@ yarn watch
7574

7675
### Update VS Code
7776

78-
Updating VS Code requires `git subtree`. On some RPM-based Linux distros, `git
79-
subtree` is not included by default and needs to be installed separately. To
77+
Updating VS Code requires `git subtree`. On some RPM-based Linux distros, `git subtree` is not included by default and needs to be installed separately. To
8078
install, run `dnf install git-subtree` or `yum install git-subtree`.
8179

8280
To update VS Code:

docs/FAQ.md

+27-29
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,32 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# FAQ
44

5-
- [FAQ](#faq)
6-
- [Questions?](#questions)
7-
- [How should I expose code-server to the internet?](#how-should-i-expose-code-server-to-the-internet)
8-
- [Can I use code-server on the iPad?](#can-i-use-code-server-on-the-ipad)
9-
- [How does the config file work?](#how-does-the-config-file-work)
10-
- [How do I make my keyboard shortcuts work?](#how-do-i-make-my-keyboard-shortcuts-work)
11-
- [Why can't code-server use Microsoft's extension marketplace?](#why-cant-code-server-use-microsofts-extension-marketplace)
12-
- [How can I request an extension that's missing from the marketplace?](#how-can-i-request-an-extension-thats-missing-from-the-marketplace)
13-
- [How do I install an extension?](#how-do-i-install-an-extension)
14-
- [How do I install an extension manually?](#how-do-i-install-an-extension-manually)
15-
- [How do I use my own extensions marketplace?](#how-do-i-use-my-own-extensions-marketplace)
16-
- [Where are extensions stored?](#where-are-extensions-stored)
17-
- [How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration)
18-
- [How does code-server decide what workspace or folder to open?](#how-does-code-server-decide-what-workspace-or-folder-to-open)
19-
- [How do I access my Documents/Downloads/Desktop folders in code-server on macOS?](#how-do-i-access-my-documentsdownloadsdesktop-folders-in-code-server-on-macos)
20-
- [How do I direct server-side requests through a proxy?](#how-do-i-direct-server-side-requests-through-a-proxy)
21-
- [How do I debug issues with code-server?](#how-do-i-debug-issues-with-code-server)
22-
- [What is the healthz endpoint?](#what-is-the-healthz-endpoint)
23-
- [What is the heartbeat file?](#what-is-the-heartbeat-file)
24-
- [How do I change the password?](#how-do-i-change-the-password)
25-
- [Can I store my password hashed?](#can-i-store-my-password-hashed)
26-
- [Is multi-tenancy possible?](#is-multi-tenancy-possible)
27-
- [Can I use Docker in a code-server container?](#can-i-use-docker-in-a-code-server-container)
28-
- [How do I disable telemetry?](#how-do-i-disable-telemetry)
29-
- [What's the difference between code-server and Theia?](#whats-the-difference-between-code-server-and-theia)
30-
- [What's the difference between code-server and VS Code Codespaces?](#whats-the-difference-between-code-server-and-vs-code-codespaces)
31-
- [Are there community projects involving code-server?](#are-there-community-projects-involving-code-server)
5+
- [Questions?](#questions)
6+
- [How should I expose code-server to the internet?](#how-should-i-expose-code-server-to-the-internet)
7+
- [Can I use code-server on the iPad?](#can-i-use-code-server-on-the-ipad)
8+
- [How does the config file work?](#how-does-the-config-file-work)
9+
- [How do I make my keyboard shortcuts work?](#how-do-i-make-my-keyboard-shortcuts-work)
10+
- [Why can't code-server use Microsoft's extension marketplace?](#why-cant-code-server-use-microsofts-extension-marketplace)
11+
- [How can I request an extension that's missing from the marketplace?](#how-can-i-request-an-extension-thats-missing-from-the-marketplace)
12+
- [How do I install an extension?](#how-do-i-install-an-extension)
13+
- [How do I install an extension manually?](#how-do-i-install-an-extension-manually)
14+
- [How do I use my own extensions marketplace?](#how-do-i-use-my-own-extensions-marketplace)
15+
- [Where are extensions stored?](#where-are-extensions-stored)
16+
- [How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration)
17+
- [How does code-server decide what workspace or folder to open?](#how-does-code-server-decide-what-workspace-or-folder-to-open)
18+
- [How do I access my Documents/Downloads/Desktop folders in code-server on macOS?](#how-do-i-access-my-documentsdownloadsdesktop-folders-in-code-server-on-macos)
19+
- [How do I direct server-side requests through a proxy?](#how-do-i-direct-server-side-requests-through-a-proxy)
20+
- [How do I debug issues with code-server?](#how-do-i-debug-issues-with-code-server)
21+
- [What is the healthz endpoint?](#what-is-the-healthz-endpoint)
22+
- [What is the heartbeat file?](#what-is-the-heartbeat-file)
23+
- [How do I change the password?](#how-do-i-change-the-password)
24+
- [Can I store my password hashed?](#can-i-store-my-password-hashed)
25+
- [Is multi-tenancy possible?](#is-multi-tenancy-possible)
26+
- [Can I use Docker in a code-server container?](#can-i-use-docker-in-a-code-server-container)
27+
- [How do I disable telemetry?](#how-do-i-disable-telemetry)
28+
- [What's the difference between code-server and Theia?](#whats-the-difference-between-code-server-and-theia)
29+
- [What's the difference between code-server and VS Code Codespaces?](#whats-the-difference-between-code-server-and-vs-code-codespaces)
30+
- [Are there community projects involving code-server?](#are-there-community-projects-involving-code-server)
3231

3332
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
3433

@@ -63,8 +62,7 @@ The default config defines the following behavior:
6362
- Enable password authorization
6463
- Do not use TLS
6564
66-
Each key in the file maps directly to a `code-server` flag (run `code-server
67-
--help` to see a listing of all the flags). Any flags passed to `code-server`
65+
Each key in the file maps directly to a `code-server` flag (run `code-server --help` to see a listing of all the flags). Any flags passed to `code-server`
6866
will take priority over the config file.
6967

7068
You can change the config file's location using the `--config` flag or

docs/MAINTAINING.md

+10-11
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,16 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# Maintaining
44

5-
- [Maintaining](#maintaining)
6-
- [Workflow](#workflow)
7-
- [Milestones](#milestones)
8-
- [Triage](#triage)
9-
- [Project boards](#project-boards)
10-
- [Versioning](#versioning)
11-
- [Pull requests](#pull-requests)
12-
- [Merge strategies](#merge-strategies)
13-
- [Changelog](#changelog)
14-
- [Releases](#releases)
15-
- [Publishing a release](#publishing-a-release)
5+
- [Workflow](#workflow)
6+
- [Milestones](#milestones)
7+
- [Triage](#triage)
8+
- [Project boards](#project-boards)
9+
- [Versioning](#versioning)
10+
- [Pull requests](#pull-requests)
11+
- [Merge strategies](#merge-strategies)
12+
- [Changelog](#changelog)
13+
- [Releases](#releases)
14+
- [Publishing a release](#publishing-a-release)
1615

1716
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
1817

docs/guide.md

+32-33
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,19 @@
11
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
3-
# Setup
4-
5-
- [Setup](#setup)
6-
- [Expose code-server](#expose-code-server)
7-
- [Port forwarding via SSH](#port-forwarding-via-ssh)
8-
- [Using Let's Encrypt with Caddy](#using-lets-encrypt-with-caddy)
9-
- [Using Let's Encrypt with NGINX](#using-lets-encrypt-with-nginx)
10-
- [Using a self-signed certificate](#using-a-self-signed-certificate)
11-
- [External authentication](#external-authentication)
12-
- [HTTPS](#https)
13-
- [Self Signed Certificate](#self-signed-certificate)
14-
- [Using a subdomain](#using-a-subdomain)
15-
- [Using a subpath](#using-a-subpath)
16-
- [Stripping `/proxy/<port>` from the request path](#stripping-proxyport-from-the-request-path)
17-
- [Proxying to create a React app](#proxying-to-create-a-react-app)
3+
# Setup Guide
4+
5+
- [Expose code-server](#expose-code-server)
6+
- [Port forwarding via SSH](#port-forwarding-via-ssh)
7+
- [Using Let's Encrypt with Caddy](#using-lets-encrypt-with-caddy)
8+
- [Using Let's Encrypt with NGINX](#using-lets-encrypt-with-nginx)
9+
- [Using a self-signed certificate](#using-a-self-signed-certificate)
10+
- [External authentication](#external-authentication)
11+
- [HTTPS](#https)
12+
- [Self Signed Certificate](#self-signed-certificate)
13+
- [Using a subdomain](#using-a-subdomain)
14+
- [Using a subpath](#using-a-subpath)
15+
- [Stripping `/proxy/<port>` from the request path](#stripping-proxyport-from-the-request-path)
16+
- [Proxying to create a React app](#proxying-to-create-a-react-app)
1817

1918
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
2019

@@ -85,8 +84,8 @@ we recommend using another method, such as [Let's Encrypt](#let-encrypt) instead
8584
# This is the same as the above SSH command, but it runs in the background
8685
# continuously. Be sure to add `mutagen daemon start` to your ~/.bashrc to
8786
# start the mutagen daemon when you open a shell.
88-
89-
mutagen forward create --name=code-server tcp:127.0.0.1:8080 <instance-ip>:tcp:127.0.0.1:8080
87+
88+
mutagen forward create --name=code-server tcp:127.0.0.1:8080 < instance-ip > :tcp:127.0.0.1:8080
9089
```
9190

9291
6. Optional, but highly recommended: add the following to `~/.ssh/config` so
@@ -111,19 +110,19 @@ access code-server on an iPad or do not want to use SSH port forwarding.
111110
1. This option requires that the remote machine be exposed to the internet. Make sure that your instance allows HTTP/HTTP traffic.
112111

113112
1. You'll need a domain name (if you don't have one, you can purchase one from
114-
[Google Domains](https://domains.google.com) or the domain service of your
115-
choice)). Once you have a domain name, add an A record to your domain that contains your
116-
instance's IP address.
113+
[Google Domains](https://domains.google.com) or the domain service of your
114+
choice)). Once you have a domain name, add an A record to your domain that contains your
115+
instance's IP address.
117116

118117
1. Install [Caddy](https://caddyserver.com/docs/download#debian-ubuntu-raspbian):
119118

120-
```console
121-
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
122-
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/gpg/gpg.155B6D79CA56EA34.key' | sudo apt-key add -
123-
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/setup/config.deb.txt?distro=debian&version=any-version' | sudo tee -a /etc/apt/sources.list.d/caddy-stable.list
124-
sudo apt update
125-
sudo apt install caddy
126-
```
119+
```console
120+
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
121+
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/gpg/gpg.155B6D79CA56EA34.key' | sudo apt-key add -
122+
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/setup/config.deb.txt?distro=debian&version=any-version' | sudo tee -a /etc/apt/sources.list.d/caddy-stable.list
123+
sudo apt update
124+
sudo apt install caddy
125+
```
127126

128127
1. Replace `/etc/caddy/Caddyfile` using `sudo` so that the file looks like this:
129128

@@ -158,9 +157,9 @@ At this point, you should be able to access code-server via
158157
1. This option requires that the remote machine be exposed to the internet. Make sure that your instance allows HTTP/HTTP traffic.
159158

160159
1. You'll need a domain name (if you don't have one, you can purchase one from
161-
[Google Domains](https://domains.google.com) or the domain service of your
162-
choice)). Once you have a domain name, add an A record to your domain that contains your
163-
instance's IP address.
160+
[Google Domains](https://domains.google.com) or the domain service of your
161+
choice)). Once you have a domain name, add an A record to your domain that contains your
162+
instance's IP address.
164163

165164
1. Install NGINX:
166165

@@ -220,7 +219,7 @@ certificates do not work with iPads and may cause unexpected issues with
220219
code-server. You should only proceed with this option if:
221220

222221
- You do not want to buy a domain or you cannot expose the remote machine to
223-
the internet
222+
the internet
224223
- You do not want to use port forwarding via SSH
225224

226225
To use a self-signed certificate:
@@ -278,7 +277,7 @@ If you pass a certificate to code-server, it will respond to HTTPS requests and
278277
redirect all HTTP requests to HTTPS.
279278

280279
> You can use [Let's Encrypt](https://letsencrypt.org/) to get a TLS certificate
281-
for free.
280+
> for free.
282281
283282
### Self Signed Certificate
284283

@@ -303,7 +302,7 @@ code-server --proxy-domain <domain>
303302
```
304303

305304
Now you can browse to `<port>.<domain>`. Note that this uses the host header, so
306-
ensure your reverse proxy (if you're using one) forwards that information.
305+
ensure your reverse proxy (if you're using one) forwards that information.
307306

308307
### Using a subpath
309308

docs/install.md

+13-31
Original file line numberDiff line numberDiff line change
@@ -2,37 +2,19 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# Install
44

5-
<<<<<<< HEAD
6-
- [Install](#install)
7-
- [install.sh](#installsh)
8-
- [Detection reference](#detection-reference)
9-
- [yarn, npm](#yarn-npm)
10-
- [Standalone releases](#standalone-releases)
11-
- [Debian, Ubuntu](#debian-ubuntu)
12-
- [Fedora, CentOS, RHEL, SUSE](#fedora-centos-rhel-suse)
13-
- [Arch Linux](#arch-linux)
14-
- [macOS](#macos)
15-
- [Docker](#docker)
16-
- [Helm](#helm)
17-
- [Raspberry Pi](#raspberry-pi)
18-
- [Termux](#termux)
19-
- [Cloud providers](#cloud-providers)
20-
=======
21-
- [Install](#install)
22-
- [install.sh](#installsh)
23-
- [Detection reference](#detection-reference)
24-
- [yarn, npm](#yarn-npm)
25-
- [Standalone releases](#standalone-releases)
26-
- [Debian, Ubuntu](#debian-ubuntu)
27-
- [Fedora, CentOS, RHEL, SUSE](#fedora-centos-rhel-suse)
28-
- [Arch Linux](#arch-linux)
29-
- [macOS](#macos)
30-
- [Docker](#docker)
31-
- [Helm](#helm)
32-
- [Raspberry Pi](#raspberry-pi)
33-
- [Termux](#termux)
34-
- [Cloud providers](#cloud-providers)
35-
>>>>>>> main
5+
- [install.sh](#installsh)
6+
- [Detection reference](#detection-reference)
7+
- [yarn, npm](#yarn-npm)
8+
- [Standalone releases](#standalone-releases)
9+
- [Debian, Ubuntu](#debian-ubuntu)
10+
- [Fedora, CentOS, RHEL, SUSE](#fedora-centos-rhel-suse)
11+
- [Arch Linux](#arch-linux)
12+
- [macOS](#macos)
13+
- [Docker](#docker)
14+
- [Helm](#helm)
15+
- [Raspberry Pi](#raspberry-pi)
16+
- [Termux](#termux)
17+
- [Cloud providers](#cloud-providers)
3618

3719
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
3820

docs/ipad.md

+13-14
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,15 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# iPad
44

5-
- [iPad](#ipad)
6-
- [Using the code-server progressive web app (PWA)](#using-the-code-server-progressive-web-app-pwa)
7-
- [Access code-server with a self-signed certificate on an iPad](#access-code-server-with-a-self-signed-certificate-on-an-ipad)
8-
- [Certificate requirements](#certificate-requirements)
9-
- [Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad)
10-
- [Access code-server using Servediter](#access-code-server-using-servediter)
11-
- [Raspberry Pi USB-C network](#raspberry-pi-usb-c-network)
12-
- [Recommendations](#recommendations)
13-
- [Known issues](#known-issues)
14-
- [Workaround for issue with `ctrl+c` not stopping a running process in the terminal](#workaround-for-issue-with-ctrlc-not-stopping-a-running-process-in-the-terminal)
5+
- [Using the code-server progressive web app (PWA)](#using-the-code-server-progressive-web-app-pwa)
6+
- [Access code-server with a self-signed certificate on an iPad](#access-code-server-with-a-self-signed-certificate-on-an-ipad)
7+
- [Certificate requirements](#certificate-requirements)
8+
- [Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad)
9+
- [Access code-server using Servediter](#access-code-server-using-servediter)
10+
- [Raspberry Pi USB-C network](#raspberry-pi-usb-c-network)
11+
- [Recommendations](#recommendations)
12+
- [Known issues](#known-issues)
13+
- [Workaround for issue with `ctrl+c` not stopping a running process in the terminal](#workaround-for-issue-with-ctrlc-not-stopping-a-running-process-in-the-terminal)
1514

1615
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
1716

@@ -72,7 +71,7 @@ To share a self-signed certificate with an iPad:
7271
the certificate's location in its logs:
7372

7473
```console
75-
[2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt
74+
[2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt
7675
```
7776

7877
2. Send the certificate to the iPad, either by emailing it to yourself or using
@@ -173,8 +172,8 @@ and tricks helpful:
173172
- See [workaround](#ctrl-c-workaround)
174173

175174
Additionally, see [issues in the code-server repo that are tagged with the iPad
176-
label](https://github.com/cdr/code-server/issues?q=is%3Aopen+is%3Aissue+label%3AiPad)
177-
for more information.
175+
label](https://github.com/cdr/code-server/issues?q=is%3Aopen+is%3Aissue+label%3AiPad)
176+
for more information.
178177

179178
### Workaround for issue with `ctrl+c` not stopping a running process in the terminal
180179

@@ -199,4 +198,4 @@ In the meantime, you can manually define a shortcut as a workaround:
199198
}
200199
```
201200

202-
*Source: [StackOverflow](https://stackoverflow.com/a/52735954/3015595)*
201+
_Source: [StackOverflow](https://stackoverflow.com/a/52735954/3015595)_

docs/npm.md

+8-10
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,13 @@
22
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
33
# npm Install Requirements
44

5-
- [npm Install Requirements](#npm-install-requirements)
6-
- [Node.js version](#nodejs-version)
7-
- [Ubuntu, Debian](#ubuntu-debian)
8-
- [Fedora, CentOS, RHEL](#fedora-centos-rhel)
9-
- [Alpine](#alpine)
10-
- [macOS](#macos)
11-
- [FreeBSD](#freebsd)
12-
- [Issues with Node.js after version upgrades](#issues-with-nodejs-after-version-upgrades)
5+
- [Node.js version](#nodejs-version)
6+
- [Ubuntu, Debian](#ubuntu-debian)
7+
- [Fedora, CentOS, RHEL](#fedora-centos-rhel)
8+
- [Alpine](#alpine)
9+
- [macOS](#macos)
10+
- [FreeBSD](#freebsd)
11+
- [Issues with Node.js after version upgrades](#issues-with-nodejs-after-version-upgrades)
1312

1413
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
1514

@@ -77,8 +76,7 @@ directory and running `npm rebuild` to recompile the modules.
7776
A step-by-step example of how you might do this is:
7877

7978
1. Install code-server: `brew install code-server`
80-
2. Navigate into the directory: `cd
81-
/usr/local/Cellar/code-server/<version>/libexec/lib/vscode/`
79+
2. Navigate into the directory: `cd /usr/local/Cellar/code-server/<version>/libexec/lib/vscode/`
8280
3. Recompile the native modules: `npm rebuild`
8381
4. Restart code-server
8482

0 commit comments

Comments
 (0)