From 8ed5b736bb4a579f940c100eed5432ddd3caf072 Mon Sep 17 00:00:00 2001
From: Joe Previte <jjprevite@gmail.com>
Date: Wed, 31 Mar 2021 08:28:55 -0700
Subject: [PATCH] feat(ranger): add action for extension-request (#2967)

---
 .github/ranger.yml | 14 ++++++++++++++
 docs/FAQ.md        | 40 +++++++++++++++++++++++++++++++++++-----
 2 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/.github/ranger.yml b/.github/ranger.yml
index a756c666..e1abce2c 100644
--- a/.github/ranger.yml
+++ b/.github/ranger.yml
@@ -8,6 +8,8 @@ default:
 
     # Default comment to post when an issue is first marked with a closing label
     comment: "⚠️ This issue has been marked $LABEL and will be closed in $DELAY."
+  close-faster:
+    delay: "1 minute"
 
 labels:
   duplicate: close
@@ -23,3 +25,15 @@ labels:
     action: comment
     delay: 5s
     message: "Thanks for making your first contribution! :slightly_smiling_face:"
+  extension-request:
+    action: close-faster
+    delay: 5s
+    message: >
+      Thanks for opening an extension request!
+      We are currently in the process of switching extension
+      marketplaces and transitioning over to [Open VSX](https://open-vsx.org/).
+      Once https://github.com/eclipse/openvsx/issues/249 is implemented, we
+      can fully make this transition. Therefore, we are no longer accepting
+      new requests for extension requests. We suggest installing the VSIX
+      file and then installing into code-server as a temporary workaround.
+      See [docs](https://github.com/cdr/code-server/blob/main/docs/FAQ.md#installing-vsix-extensions-via-the-command-line) for more info."
diff --git a/docs/FAQ.md b/docs/FAQ.md
index 9b570ff3..6a569e5d 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -7,7 +7,9 @@
 - [Community Projects (awesome-code-server)](#community-projects-awesome-code-server)
 - [How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration)
 - [Differences compared to VS Code?](#differences-compared-to-vs-code)
+  - [Installing an extension](#installing-an-extension)
 - [How can I request a missing extension?](#how-can-i-request-a-missing-extension)
+- [Installing an extension manually](#installing-an-extension-manually)
 - [How do I configure the marketplace URL?](#how-do-i-configure-the-marketplace-url)
 - [Where are extensions stored?](#where-are-extensions-stored)
 - [How is this different from VS Code Codespaces?](#how-is-this-different-from-vs-code-codespaces)
@@ -82,15 +84,43 @@ These are the closed source extensions presently unavailable:
 
 For more about the closed source parts of VS Code, see [vscodium/vscodium](https://github.com/VSCodium/vscodium#why-does-this-exist).
 
+### Installing an extension
+
+Extensions can be installed from the marketplace using the extensions sidebar in
+code-server or from the command line:
+
+```shell
+code-server --install-extension <extension id>
+# example: code-server --install-extension wesbos.theme-cobalt2
+```
+
 ## How can I request a missing extension?
 
-Please open a new issue and select the `Extension request` template.
+We are currently in the process of transitioning to [Open VSX](https://open-vsx.org/).
+Once https://github.com/eclipse/openvsx/issues/249
+is implemented, we can fully make this transition. Therefore, we are no longer
+accepting new requests for extension requests.
 
-If an extension is not available or does not work, you can grab its VSIX from its Github releases or
-build it yourself. Then run the `Extensions: Install from VSIX` command in the Command Palette and
-point to the .vsix file.
+Instead, we suggest one of the following:
 
-See below for installing an extension from the cli.
+- [Switch to Open VSX](#how-do-i-configure-the-marketplace-url) now
+- Download and [install the extension manually](#installing-an-extension-manually)
+
+## Installing an extension manually
+
+If an extension is not available from the marketplace or does not work, you can
+grab its VSIX from its GitHub releases or build it yourself.
+
+Once you have downloaded the VSIX to the remote machine you can either:
+
+- Run the `Extensions: Install from VSIX` command in the Command Palette.
+- Use `code-server --install-extension <path to vsix>`
+
+You can also download extensions from the command line. For instance, downloading off OpenVSX can be done like this:
+
+```shell
+SERVICE_URL=https://open-vsx.org/vscode/gallery ITEM_URL=https://open-vsx.org/vscode/item code-server --install-extension <extension id>
+```
 
 ## How do I configure the marketplace URL?