.vscode

Author: denisecase

.gitignore

@@ -28,7 +28,7 @@ PRIVATE-NOTES.md
 # === VS Code (special case) ===
 
 # WHY: Ignore editor state while allowing a shared baseline configuration.
-.vscode/
+#.vscode/
 
 # WHY: Commit recommended extensions (opt-in) for consistent development experience.
 # NOTE: Share recommendations, not personal editor styles or preferences.

.vscode/ABOUT_THIS_FOLDER.md

@@ -0,0 +1,34 @@
+# VS Code Configuration (`.vscode/`)
+
+This folder contains **optional editor configuration files** for Visual Studio Code.
+They are provided to support a consistent, professional development experience,
+but **nothing in this folder is required to run the code**.
+
+## Scope
+
+You do not need to understand or edit these files.
+They exist to:
+- prevent common conflicts
+- model professional project structure
+
+
+## Important Note About JSON and Comments
+
+**Standard JSON does NOT allow comments.**
+
+However, **VS Code intentionally allows comments** in certain configuration files
+inside the `.vscode/` folder as a documented exception.
+
+This means:
+- These files are valid **for VS Code only**
+- They should **not** be reused as general-purpose JSON files
+- Comments are used here deliberately for teaching and documentation
+
+Do not copy these files into other tools or contexts that expect strict JSON.
+
+## Files
+
+- `extensions.json` Recommends VS Code extensions as **suggestions**, not requirements. VS Code may prompt you to install these when you open the project.
+
+- `settings.json` (Optional) Editor preferences that apply only to this workspace,
+such as formatting behavior or linting integration.

.vscode/extensions.json

@@ -0,0 +1,49 @@
+{
+  "recommendations": [
+    // ============================================================
+    // === TODO Task Management ===
+    // ============================================================
+    "gruntfuggly.todo-tree", // TODO/FIXME comment tracking
+    // ============================================================
+    // === PYTHON DEVELOPMENT ===
+    // ============================================================
+    "ms-python.python", // Core Python support
+    "ms-python.vscode-pylance", // Fast IntelliSense and type checking
+    "charliermarsh.ruff", // Modern formatting and linting (replaces black + isort + flake8)
+    // ============================================================
+    // === FILE PATH ASSISTANCE ===
+    // ============================================================
+    "christian-kohler.path-intellisense", // Autocomplete for file paths in Python strings (e.g., "data/file.csv")
+    // NOTE: Terminal autocomplete (tab/right-arrow) is built into your shell (bash/zsh/PowerShell), not VS Code
+    // ============================================================
+    // === MARKDOWN AND DOCUMENTATION ===
+    // ============================================================
+    "yzhang.markdown-all-in-one", // Shortcuts, TOC, formatting for .md files
+    "bierner.markdown-preview-github-styles", // GitHub-style markdown preview
+    // "bierner.markdown-mermaid", // Diagram rendering in markdown (flowcharts, etc.)
+    // ============================================================
+    // === DATA FILES AND CONFIGURATION ===
+    // ============================================================
+    "redhat.vscode-yaml", // YAML syntax, validation, formatting
+    "tamasfe.even-better-toml", // TOML syntax, validation (for pyproject.toml)
+    "mechatroner.rainbow-csv", // Color-code CSV columns for readability
+    // ============================================================
+    // === PROJECT INFRASTRUCTURE ===
+    // ============================================================
+    "editorconfig.editorconfig", // Respects .editorconfig settings (indentation, line endings)
+    "github.vscode-github-actions", // Syntax highlighting for .github/workflows/*.yml
+  ],
+  "unwantedRecommendations": [
+    // ============================================================
+    // === NOT RECOMMENDED: CONFLICTS WITH CURRENT SETUP ===
+    // ============================================================
+    "esbenp.prettier-vscode", // We use ruff for Python, built-in formatters for JSON/YAML
+    "ms-pyright.pyright", // Use Pylance (Pyright engine) instead to avoid duplicate diagnostics
+    "ms-python.black-formatter", // We use ruff format instead
+    "ms-python.isort", // We use ruff for import sorting
+    "ms-vscode.live-server", // Not needed for Python/analytics projects
+    "ritwickdey.liveserver", // Duplicate of above
+    "ms-vscode-remote.remote-containers", // OPTIONAL: Not recommended - local dev preferred
+    "eamodio.gitlens", // OPTIONAL: Powerful for work; noisy for individual projects
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,40 @@
+// .vscode/settings.json
+{
+  "editor.formatOnSave": false,
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
+  "python.terminal.activateEnvironment": true,
+  "python.analysis.typeCheckingMode": "basic",
+  "python.analysis.diagnosticSeverityOverrides": {
+    "reportMissingTypeStubs": "none"
+  },
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "yzhang.markdown-all-in-one"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "redhat.vscode-yaml"
+  },
+  "[yml]": {
+    "editor.defaultFormatter": "redhat.vscode-yaml"
+  },
+  "[toml]": {
+    "editor.defaultFormatter": "tamasfe.even-better-toml"
+  },
+  "[github-actions-workflow]": {
+    "editor.defaultFormatter": "redhat.vscode-yaml"
+  },
+  "yaml.schemas": {
+    "https://json.schemastore.org/github-workflow.json": [
+      ".github/workflows/*.yml",
+      ".github/workflows/*.yaml"
+    ]
+  }
+}