feat: explain the SSH blocks now that we own the included file

Point users at "coder.sshConfig" from the block they are told not to
edit, and say what the include is for in the file they own.

Author: EhabY

src/remote/sshConfig.ts

@@ -259,7 +259,9 @@ export class SshConfig {
 		}
 		const include = [
 			INCLUDE_START,
-			"# Keep this first: SSH uses the first value it obtains for each option.",
+			"# Your Coder workspaces live in the included file, which is managed",
+			"# by the Coder VS Code extension. SSH uses the first value it obtains",
+			"# for each option, so anything above this block overrides them.",
 			`Include ${includePath}`,
 			INCLUDE_END,
 		].join("\n");
@@ -341,8 +343,8 @@ export class SshConfig {
 		const { Host, ...otherValues } = values;
 		const lines = [
 			this.startBlockComment(safeHostname),
-			"# This section is managed by the Coder VS Code extension.",
-			"# Changes will be overwritten on the next workspace connection.",
+			"# Rewritten by the Coder VS Code extension on every connection.",
+			'# To change these options, use the "coder.sshConfig" setting instead.',
 			`Host ${Host}`,
 		];
 

test/unit/remote/sshConfig.test.ts

@@ -16,8 +16,8 @@ import { createMockLogger } from "../../mocks/testHelpers";
 const sshFilePath = "/Path/To/UserHomeDir/.sshConfigDir/sshConfigFile";
 const sshTempFilePrefix =
 	"/Path/To/UserHomeDir/.sshConfigDir/.sshConfigFile.vscode-coder-tmp-";
-const managedHeader = `# This section is managed by the Coder VS Code extension.
-# Changes will be overwritten on the next workspace connection.`;
+const managedHeader = `# Rewritten by the Coder VS Code extension on every connection.
+# To change these options, use the "coder.sshConfig" setting instead.`;
 
 const mockFileSystem = {
 	mkdir: vi.fn(),
@@ -861,7 +861,9 @@ Host work-server
 
 describe("updateInclude", () => {
 	const include = `# --- START CODER VSCODE INCLUDE ---
-# Keep this first: SSH uses the first value it obtains for each option.
+# Your Coder workspaces live in the included file, which is managed
+# by the Coder VS Code extension. SSH uses the first value it obtains
+# for each option, so anything above this block overrides them.
 Include ~/.ssh/coder/config
 # --- END CODER VSCODE INCLUDE ---`;