Updated readme

Author: CharlieDigital

README.md

@@ -8,8 +8,6 @@ Many teams may find themselves in this position after dealing with TypeScript is
 
 Particularly on the backend, the dynamic type system of JS (and therefore, TS) can be a bane when it comes to ensuring data quality and system correctness.
 
-JavaScript's single-threaded nature also means that it can feel limiting for both runtime throughput and the possible tools developers can use to solve performance sensitive problems (e.g. processing a large CSV in parallel in a compute intensive scenario).
-
 I hope that these docs can help convince you that C# is a very realistic pathway if your team is already comfortable with TypeScript and frameworks like Nest.js.
 
 Check out the published docs ***and please leave feedback***!
@@ -23,14 +21,60 @@ Fork and make a PR!  Most of this repo is simply markdown so it's easy to contri
 To run locally:
 
 ```shell
+# Install dependencies
+cd docs
+yarn
+
 # From the root
 yarn --cwd docs docs:dev
 ```
 
+## Code Examples
+
+To test your code examples:
+
+### TypeScript
+
+1. Use [TypeScript Playground](https://www.typescriptlang.org/play/?#)
+2. For more comprehensive examples, create a sample project in `src/typescript`
+3. Use the `src/typescript/js-notebook.dib` for simple JavaScript examples
+
+### C#
+
+1. Use the C# notebook in `src/csharp/csharp-notebook.dib`
+2. Create a single file app in `src/csharp/fileapps`
+3. Create a full project and add it to the top-level solution.
+
+## Authoring Tips
+
+The code splitter is a custom Vue component.
+
+To use the code splitter:
+
+````html
+<CodeSplitter>
+  <template #left>
+
+    ```ts
+    // TS/JS code goes here
+    ```
+
+  </template>
+  <template #right>
+
+   ```cs
+   // C# code goes here
+   ```
+
+  </template>
+</CodeSplitter>
+````
+
+> 💡 ***Note*** the extra space after the opening `<template>` and before the closing `</template>`.  This is necessary for the VitePress pre-processor.
+
 ## Guidelines
 
-- No trashing either language; we're focused on educating
+- Focus on educating; you don't have to be able to fill in both sides (C# and JS); you can fill in one side and leave the other "WIP"
 - Write clear, concise, and easy to follow examples
 - Try to distill the examples down to the simplest use case that demonstrates the idea
-- Write both TS and C# except for cases where it's focused on a C# specific language feature
 - Use [VitePress markdown extensions](https://vitepress.dev/guide/markdown) where appropriate including code line highlighting

typescript-is-like-csharp.sln

@@ -0,0 +1,9 @@
+<Solution>
+  <Project Path="src/csharp/console/console.csproj" />
+  <Project Path="src/csharp/csharpier-example/csharpier-example.csproj" />
+  <Project Path="src/csharp/editorconfig-example/editorconfig-example.csproj" />
+  <Project Path="src/csharp/ef-api/ef-api.csproj" />
+  <Project Path="src/csharp/tunit-example/tunit-example.csproj" />
+  <Project Path="src/csharp/webapi-controllers/webapi-controllers.csproj" />
+  <Project Path="src/csharp/webapi-minimal/webapi-minimal.csproj" />
+</Solution>