Add comments now the workaround has been validated

Author: gjsjohnmurray

src/api/index.ts

@@ -306,6 +306,11 @@ export class AtelierAPI {
     const http = this._config.https ? httpsModule : httpModule;
     if (!this._agent) {
       this._agent = new http.Agent({
+        /* VS Code 1.93 adopted a version of vscode-proxy-agent that fixed a failure to pass-through the keepAlive option (see https://github.com/microsoft/vscode/issues/173861 and https://github.com/microsoft/vscode-proxy-agent/commit/4eddc930d4fbc6b88ca5557ea7af07d623d390d6)
+         * This caused poor performance on some operations by our extension (see https://github.com/intersystems-community/vscode-objectscript/issues/1428)
+         * Short term solution adopted by PR https://github.com/intersystems-community/vscode-objectscript/pull/1432 is not to enable keepAlive
+         * We should revisit this in the future - TODO
+         */
         //keepAlive: true,
         //maxSockets: 10,
         rejectUnauthorized: https && vscode.workspace.getConfiguration("http").get("proxyStrictSSL"),