👷 one-click dev setup for vscode (#241)

- Improve `make package` & `update-vsce`
- `package` needs to `install` first.
- Changed `npm install @vscode/vsce` to `update` as it otherwise changes the ordering in `package.json`

Author: tennox

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Launch Extension",
+            "type": "extensionHost",
+            "request": "launch",
+            "args": [
+                // development in clean environment - source: https://github.com/microsoft/vscode/issues/159572#issuecomment-1240523504
+                "--profile=extension-dev", // optional, but recommended - will launch extension in a clean instance
+                // "--profile-temp", // alternative - will launch extension in a clean instance everytime
+                "--extensionDevelopmentPath=${workspaceFolder}",
+            ],
+            "outFiles": [
+                "${workspaceFolder}/out/**/*.js"
+            ],
+            "preLaunchTask": "npm: watch",
+        }
+    ]
+}

.vscode/tasks.json

@@ -0,0 +1,46 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "npm",
+			"script": "install",
+			"group": "build",
+			"isBackground": true,
+			"problemMatcher": [],
+			"presentation": {
+				"reveal": "silent"
+			},
+			"label": "npm: install",
+			"detail": "install dependencies from package"
+		},
+		/* from: https://github.com/microsoft/vscode-extension-samples/blob/main/helloworld-sample/.vscode/tasks.json */
+		{
+			"type": "npm",
+			"script": "watch",
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			},
+			"dependsOn": [
+				"npm: install"
+			],
+			"isBackground": true,
+			"problemMatcher": {
+				"owner": "custom",
+				"pattern": {
+					"regexp": "IMJUSTHEREBECAUSETHERENEEDSTOBEADEFAULT - https://github.com/microsoft/vscode/issues/6209#issuecomment-1378126445"
+				},
+				"background": {
+					"activeOnStart": true,
+					"beginsPattern": "rollup v", // e.g. 'rollup v3.18.0'
+					"endsPattern": "waiting for changes..."
+				},
+			},
+			"presentation": {
+				"reveal": "silent"
+			},
+			"label": "npm: watch",
+			"detail": "compile & watch"
+		}
+	]
+}

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing
+
+This plugin is far from feature-complete.  
+If you want to improve it, feel free to pick one of the [open issues](https://github.com/mre/vscode-snippet/issues) and give it a shot.  
+In case you need any help, just add a comment to the issue to get a conversation started. :smiley:
+
+## Dev setup
+
+Open this repo in VSCode, and you should be able to just Start the launch task "Launch Extension":
+
+![screenshot](./assets/Screenshot%20launch%20task.png)
+
+You might need to wait a moment for the first `npm install` to finish. You can see progress in the "running build tasks" section of VSCode:
+
+![screenshot](./assets/Screenshot%20build%20task.png)
+
+
+## Packaging
+Run `make package` to package a `.vsix` file.
+
+### additional commands
+To get a list of all available commands, try `make help`.  
+To test your changes, go to the Debug panel in VSCode and click on the `play` button. This will start the extension in a new window where you can test it.

Makefile

@@ -15,12 +15,12 @@ ls: ## Lists all the files that will be published
 	vsce ls
 
 .PHONY: package
-package: ## Package extension for publication
+package: install update-vsce ls ## Package extension for publication
 	vsce package
 
 .PHONY: update-vsce
 update-vsce: ## Update vsce extension manager
-	npm install @vscode/vsce
+	npm update @vscode/vsce
 
 .PHONY: publish
 publish: update-vsce ls install package ## Publish on VSCode Marketplace

README.md

@@ -115,13 +115,7 @@ You can move snippets or folders in the Snippets view by dragging and dropping t
 
 ![Preview](https://raw.githubusercontent.com/mre/vscode-snippet/master/contrib/snippets-storage/move.gif)
 
-## Development
-
-To get a list of all available commands, try `make help`.  
-To test your changes, go to the Debug panel in VSCode and click on the `play` button. This will start the extension in a new window where you can test it.
 
 ## Contributing
 
-This plugin is far from feature-complete.  
-If you want to improve it, feel free to pick one of the [open issues](https://github.com/mre/vscode-snippet/issues) and give it a shot.  
-In case you need any help, just add a comment to the issue to get a conversation started. :smiley:
+See [CONTRIBUTING.md](./CONTRIBUTING.md)