initial debugger commit - most work contributed by @KeyMaster- as part of luxe engine!

doc/notes/debugger.md

@@ -0,0 +1,30 @@
+
+# The debugger is work in progress
+
+This branch is very experimental and not finished.
+There's a lot of exploratory code that isn't well defined or cleaned up.
+This is expected.
+
+We welcome contribution to make it more complete.
+Please open a discussion to discuss major changes before doing them.
+
+https://github.com/wren-lang/wren/issues/425
+
+# Testing the debugger
+- enable `#define WREN_DEBUGGER 1` in include/wren.h
+- enable `#define WREN_DEBUGGER 1` in wren_common.h
+- call `wrenDebuggerPollConfigCmds(vm)` in e.g a main loop
+  
+# Accessing the debugger
+The debugger operates a simple protocol over a network socket. 
+You can connect to it with telnet for example and control it.
+
+The vscode extension below integrates with it for a bigger example.
+
+# The (very wip) vscode extension
+
+Debugging shown in this video in vscode was made possible using this extension: 
+https://github.com/wren-lang/wren-vscode
+
+The extension is also very rough and experimental.
+