init

enriched-qwen3-coder-next/Common/DTS.Common/Classes/WindowsFolder.md

@@ -0,0 +1,54 @@
+---
+source_files:
+  - Common/DTS.Common/Classes/WindowsFolder/WindowsFolder.cs
+generated_at: "2026-04-16T03:17:08.376962+00:00"
+model: "Qwen/Qwen3-Coder-Next-FP8"
+schema_version: 1
+sha256: "f16db9efe9d28ad5"
+---
+
+# WindowsFolder
+
+### 1. **Purpose**  
+The `WindowsFolder` class provides a utility method to open the *Manuals* folder in Windows Explorer. It is designed to support user-facing documentation access by launching the folder containing application manuals. The class assumes the *Manuals* folder resides in a subdirectory of the provided `path` argument, and relies on the runtime `CurrentDirectory` being correctly set (per comments, this is always true in the deployed environment, even for non-default installations).
+
+---
+
+### 2. **Public Interface**  
+
+#### `public static void OpenManualsFolder(string path)`  
+- **Signature**: `void OpenManualsFolder(string path)`  
+- **Behavior**: Constructs the full path to the *Manuals* folder by appending `Constants.ManualsFolder` to the input `path`, then launches Windows Explorer (`Constants.WindowsExplorer`) with that path as an argument.  
+- **Throws**: May throw `Win32Exception` (e.g., if `explorer.exe` fails to start), `InvalidOperationException` (e.g., if `Process.Start` is unsupported), or `ArgumentNullException`/`ArgumentException` if `path` is null/invalid. *(Note: Exception behavior is inferred from `Process.Start` semantics; not explicitly documented in source.)*
+
+---
+
+### 3. **Invariants**  
+- The `path` argument must represent a valid directory path (though validation is not performed in this method).  
+- The *Manuals* folder must exist at `Path.Combine(path, Constants.ManualsFolder)` for the operation to succeed meaningfully.  
+- `Constants.ManualsFolder` and `Constants.WindowsExplorer` must be non-null, non-empty strings at runtime (assumed from usage).  
+- The application’s `Environment.CurrentDirectory` is expected to be consistent with the caller’s intent (per comments), though this is not enforced here.
+
+---
+
+### 4. **Dependencies**  
+- **Internal**:  
+  - `Constants.ManualsFolder` (string constant)  
+  - `Constants.WindowsExplorer` (string constant)  
+  *(These are referenced but not defined in the provided source; must be defined in `DTS.Common.Classes.WindowsFolders` or a referenced `Constants` type.)*  
+- **External**:  
+  - `System.Diagnostics.Process` (for launching Explorer)  
+  - `System.IO.Path` (for path concatenation)  
+- **Depended on by**: Unknown from this file alone (no usage references provided). Likely called from UI layers (e.g., help menu handlers).
+
+---
+
+### 5. **Gotchas**  
+- **Path assumption**: The method *does not* use `CurrentDirectory` directly despite the comment implying reliance on it; it uses the passed `path` argument. If `path` is incorrect or outdated, the folder may not open.  
+- **No existence check**: The method does not verify that `manualsPath` exists before launching Explorer, which may result in Explorer opening an empty or non-existent folder without error feedback.  
+- **Platform dependency**: Uses Windows-specific `explorer.exe`; will fail on non-Windows platforms (no fallback or guard is present).  
+- **No async handling**: Blocking call to `Process.Start` may cause UI thread hangs if invoked synchronously on a UI thread (though `Process.Start` is typically non-blocking for Explorer).  
+- **Missing constants**: `Constants.ManualsFolder` and `Constants.WindowsExplorer` are referenced but not defined here—critical for correctness. Their values must be verified externally.  
+- **No error handling**: No try/catch around `Process.Start`; exceptions propagate directly.  
+
+*None identified beyond the above.*