fix: Improve documentation

Author: CGNonofr

src/createLanguageClient.ts

@@ -60,6 +60,13 @@ class MiddlewareMessageReader implements MessageReader {
   }
 }
 
+/**
+ * Add some hacks on transform for:
+ * - Dedup server capability registrations (for omnisharp roslyn)
+ * - Fix paths on windows
+ * @param transports The original transports
+ * @returns The transformed transports
+ */
 function hackTransports (transports: MessageTransports): MessageTransports {
   const existingRegistrations = new Set<string>()
   return {

src/services/CodinGameMonacoEnv.ts

@@ -3,19 +3,7 @@ import {
 } from 'monaco-languageclient'
 
 /**
- * Attempts to open a window and returns whether it succeeded. This technique is
- * not appropriate in certain contexts, like for example when the JS context is
- * executing inside a sandboxed iframe. If it is not necessary to know if the
- * browser blocked the new window, use {@link windowOpenNoOpener}.
- *
- * See https://github.com/microsoft/monaco-editor/issues/601
- * See https://github.com/microsoft/monaco-editor/issues/2474
- * See https://mathiasbynens.github.io/rel-noopener/
- *
- * @param url the url to open
- * @param noOpener whether or not to set the {@link window.opener} to null. You should leave the default
- * (true) unless you trust the url that is being opened.
- * @returns boolean indicating if the {@link window.open} call succeeded
+ * This function comes from vscode: https://github.com/microsoft/vscode/blob/85bf8af5b9661b0c7f9587d33b3cb61499f6e4b8/src/vs/base/browser/dom.ts#L1282
  */
 export function windowOpenWithSuccess (url: string, noOpener = true): boolean {
   const newTab = window.open()