first commit

ui/docs/editors.md

@@ -0,0 +1,32 @@
+# Editor integration
+
+- [Visual Studio Code](#visual-studio-code)
+  - [Configuration](#configuration)
+- [FAQ](#faq)
+
+## Visual Studio Code
+
+This project is best developed in VS Code. With the [recommended extensions](https://code.visualstudio.com/docs/editor/extension-gallery#_workspace-recommended-extensions) and settings in `.vscode`, you get:
+
+- Syntax highlighting for all files
+- Intellisense for all files
+- Lint-on-save for all files
+- In-editor results on save for unit tests
+
+### Configuration
+
+To configure
+
+- `.vscode/extensions.json`
+- `.vscode/settings.json`
+
+## FAQ
+
+**What kinds of editor settings and extensions should be added to the project?**
+
+All additions must:
+
+- be specific to this project
+- not interfere with any team member's workflow
+
+For example, an extension to add syntax highlighting for an included language will almost certainly be welcome, but a setting to change the editor's color theme wouldn't be appropriate.