Add instructions how to install VSCode editor (#56)

* Update `.editorconfig`
* Add `.vscode/extensions.json` for workflow recommendations

Author: tomschr

.editorconfig

@@ -3,14 +3,34 @@ root = true
 
 [*]
 end_of_line = lf
+indent_size = 2
 charset = utf-8
 max_line_length = 99
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
 
-[*.py]
+# JSON files
+[*.json]
+indent_size = 2
+
+# Python files
+[*.{py,pyi}]
 indent_style = space
 indent_size = 4
 trim_trailing_whitespace = true
 insert_final_newline = true
 
 [docs/Makefile]
 indent_style = tab
+
+[.github/workflows/*.yml]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true

.vscode/extensions.json

@@ -0,0 +1,23 @@
+{
+  // See https://code.visualstudio.com/docs/editor/extension-marketplace#_workspace-recommended-extensions
+  "recommendations": [
+    // EditorConfig extension for VS Code
+    "editorconfig.editorconfig",
+    // Python extension for VS Code
+    "ms-python.python",
+    "ms-python.vscode-python-envs",
+    "ms-python.debugpy",
+    // A Python language server, powered by pyrefly
+    "meta.pyrefly",
+    // TOML support for VS Code
+    "tamasfe.even-better-toml",
+    // RST/ReST linter, preview, IntelliSense and more
+    "lextudio.restructuredtext",
+    // support for the Ruff linter and formatter.
+    "charliermarsh.ruff",
+    // Improve your code commenting by annotating with alert, informational, TODOs, and more!
+    "aaron-bond.better-comments",
+    // Syntax highlighting for jinja(2) including HTML, Markdown etc.
+    "samuelcolvin.jinjahtml",
+  ]
+}

changelog.d/56.doc.rst

@@ -0,0 +1 @@
+Add instructions how to install VSCode editor

docs/source/developer/img/vscode-install-ext.png

@@ -16,6 +16,7 @@ This guide provides all the necessary information for contributing to the projec
 
    project-dependencies
    prepare-environment
+   install-vscode
    develop-project
    run-testsuite
    update-package

docs/source/developer/index.rst

@@ -0,0 +1,25 @@
+.. _install-vscode:
+
+Installing Visual Studio Code Editor
+====================================
+
+Visual Studio Code (VSCode) is a popular code editor that can be customized for Python development. Basically you can use any editor you like, but VSCode
+is supported by this project.
+
+Follow these steps to set up VSCode for working with this project:
+
+#. Install Visual Studio Code
+
+   Download and install VSCode from the official website: https://code.visualstudio.com/
+
+#. Install the recommended extensions
+
+   Open VSCode and go to the Extensions view by clicking on the Extensions icon.
+   In the text field, enter ``@recommended`` to see the list of recommended extensions for this project.
+
+#. Click the cloud icon next to the :guilabel:`Workspace Recommendations` header to `install all recommended extensions <https://code.visualstudio.com/docs/configure/extensions/extension-marketplace#_workspace-recommended-extensions>`_.
+
+   Alternatively, you can install the extensions one by one by clicking on the install button next to each extension.
+
+   .. image:: img/vscode-install-ext.png
+      :alt: VSCode Extensions view with highlighted cloud icon