Polish Readme

README.md

@@ -1,30 +1,48 @@
-# ![Archie](./docs/archie-small.png)  RxJS Debugger for Visual Studio Code
+# ![Archie the Debugger Owl](./docs/brand/archie-small.png)  RxJS Debugger for Visual Studio Code
 
-Adds non-intrusive debugging capabilities for [RxJS](https://rxjs.dev/) applications to [Visual Studio Code](https://code.visualstudio.com/).
+Add non-intrusive debugging capabilities for [RxJS](https://rxjs.dev/) applications to [Visual Studio Code](https://code.visualstudio.com/).
 
+![Operator Log Points with RxJS Debugger for Visual Studio Code](./docs/demo.gif)
 
 
-## Video
-
-todo
 
 ## Features
 
-- Intuitive user interface integrated in Visual Studio Code
-- Support for RxJS 6
-- Support for NodeJS applications
-  - Browser support is in the pipeline. See [Roadmap](#Roadmap) below
+- RxJS debugging, fully integrated with Visual Studio Code
+- Works with RxJS 6 and 7
+- Support for NodeJS-based RxJS applications (see [v1.0.0 milestone](https://github.com/swissmanu/rxjs-debugging-for-vscode/milestone/2) for planned browser support)
 
 ### Operator Log Points
 
-todo
+Operator log points make manually added `console.log` statements a thing of the past: RxJS Debugger detects [operators](https://rxjs.dev/guide/operators) automatically and recommends a log point:
+
+![Manage Operator Log Points](./docs/manage-operator-log-points.gif)
+
+Once you launch your application with the JavaScript debugger built-in to Visual Studio Code, enabled log points display [events of interest](https://rxjs.dev/guide/observable#anatomy-of-an-observable) directly inline in the editor:
+
+- Subscribe
+- Emitted values (next, error, complete)
+- Unsubscribe
+
+![Live Operator Log Points](./docs/live-operator-logs.gif)
+
+By default, RxJS Debugger clears logged events from the editor after you stop the JavaScript debugger. You can customize this behavior in the settings.
+
+Further, you can toggle the display of recommended log points via the command palette:
+
+![Toggle Display of Log Point Recommendations](./docs/toggle-log-points.png)
 
+## Requirements
 
+- [Visual Studio Code 1.55](https://code.visualstudio.com/) or newer
+- [NodeJS 12](https://nodejs.org/) or newer
+- [TypeScript 4.2](https://www.typescriptlang.org/) or newer
+- [RxJS 6](https://rxjs.dev/) or newer (tested with 7.0.1)
 
 ## Roadmap
 
-todo
+Refer to the [milestones overview](https://github.com/swissmanu/rxjs-debugging-for-vscode/milestones) for planned, future iterations. The [issue list](https://github.com/swissmanu/rxjs-debugging-for-vscode/issues) provides an overview on all open development topics.
 
 ## Research
 
-This extension is based on research by Manuel Alabor. Have a look at [RESEARCH.md](./RESEARCH.md) for further information.
+This extension is based on research by Manuel Alabor. See [RESEARCH.md](./RESEARCH.md) for more information.

RESEARCH.md

@@ -1,6 +1,6 @@
 # Research
 
-"RxJS Debugging for VS Code" is the result of my master studies research on the topic how developers debug RxJS-based code. Following publications and papers lead to this extension:
+"RxJS Debugging for Visual Studio Code" is the result the master studies research by Manuel Alabor on the topic how developers debug RxJS-based code.
 
 - Manuel Alabor and Markus Stolze. 2020. Debugging of  RxJS-based applications. In Proceedings of the 7th ACM SIGPLAN          International Workshop on Reactive and Event-Based Languages and Systems (REBLS 2020). Association for Computing Machinery, New York, NY, USA, 15–24. DOI: https://doi.org/10.1145/3427763.3428313