⬆️Updated docs🧹Cleaned example and C# code

Docs:
🔁Restructured README.
➕Added README to examples.
➕Rhino installation instructions.

Examples:
🧹Cleaned up folder and move prototype scripts in a folder.

.NET:
🧹Formatted C# code.

Grasshopper:
🧹Formatted C# code

Yak:
⬆️Bumped version to 2.2.0.

Sketchpad:
⬆️Updated tests.
⚒️Started to copy python implementation.

Author: usalu

README.md

@@ -5,114 +5,131 @@
         <img alt="semio" href="https://github.com/usalu/semio/" src="https://raw.githubusercontent.com/usalu/semio/main/logo/logo-horizontal.svg">
     </picture>
     <br/>
-    <a href="https://doi.org/10.5281/zenodo.8419156"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/doizenodo.svg" alt="Cite"></a>
-    <a href="https://github.com/usalu/semio/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/latestrelease.svg" alt="Latest Release"></a>
-    <a href="https://choosealicense.com/licenses/agpl-3.0/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/licenseagplv3.svg" alt="AGPLv3 License"></a>
+    <a href="https://doi.org/10.5281/zenodo.8419156"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/doizenodo.svg" alt="Cite"></a>
+    <a href="https://github.com/usalu/semio/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/latestrelease.svg" alt="Latest Release"></a>
+    <a href="https://choosealicense.com/licenses/agpl-3.0/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/licenseagplv3.svg" alt="AGPLv3 License"></a>
     <br/>
-    <a href="https://www.grasshopper3d.com/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/uigrasshopper.svg" alt="Grasshopper"></a>
-    <a href="https://dynamobim.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/uiplanneddynamo.svg" alt="Dynamo"></a>
-    <a href="https://nortikin.github.io/sverchok/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/uiplannedsverchok.svg" alt="Sverchok"></a>
+    <a href="https://www.grasshopper3d.com/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/uigrasshopper.svg" alt="Grasshopper"></a>
+    <a href="https://dynamobim.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/uiplanneddynamo.svg" alt="Dynamo"></a>
+    <a href="https://nortikin.github.io/sverchok/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/uiplannedsverchok.svg" alt="Sverchok"></a>
     <br/>
-    <a href="https://www.python.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/poweredbypython.svg" alt="Python"></a>
-    <a href="https://learn.microsoft.com/en-us/dotnet/csharp/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/poweredbycsharp.svg" alt="C#"></a>
-    <a href="https://www.typescriptlang.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/docs/badges/poweredbytypescript.svg" alt="Typescript"></a>
+    <a href="https://www.python.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/poweredbypython.svg" alt="Python"></a>
+    <a href="https://learn.microsoft.com/en-us/dotnet/csharp/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/poweredbycsharp.svg" alt="C#"></a>
+    <a href="https://www.typescriptlang.org/"><img src="https://raw.githubusercontent.com/usalu/semio/main/badges/poweredbytypescript.svg" alt="Typescript"></a>
     <br/>
     <i>Collaborative, scalable and cross-platform designing.</i>
 </p>
 <br/>
 
-You want to <emoji>✏️</emoji> the next <emoji>🏛️🏘️🏢🏭🏫🏨⛪🕌</emoji>? But <emoji>📐🔢🗣️</emoji> takes all your <emoji>⌚</emoji>? Then try to capture the <emoji>🧬</emoji> and <emoji>💉</emoji>  it into a new design and let semio <emoji>🖥️✒️🖨️</emoji>.
+You want to ✏️ the next 🏛️🏘️🏢🏭🏫🏨⛪🕌 with 🤖? But 📐🔢🗣️👥🖱️⌨️ takes all your ⌚? Then try to 🧠 the 🧬 and let semio 💉🖥️✒️🖨️🪄🚀.
 
+# What is semio?
 <p align="center">
     <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/artifacts-dark.svg">
-        <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/artifacts.svg">
-        <img alt="Capsule Tower Artifacts" src="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/artifacts.svg">
-    </picture>
-    <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/computation-dark.svg">
-        <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/computation.svg">
-        <img alt="Capsule Tower Computation" src="https://raw.githubusercontent.com/usalu/semio/main/docs/examples/nakagincapsuletower/computation.svg">
+        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/conceptual/analogies-dark.svg">
+        <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/conceptual/analogies.svg">
+        <img alt="Analogies" src="https://raw.githubusercontent.com/usalu/semio/main/conceptual/analogies.svg">
     </picture>
 </p>
 
-# What is semio?
+Let me start by what semio is **not**:
+- Rhino, SketchUp, Blender, … A *3d-modeling* tool 🐚
+    > In semio you **link** 3d-models.
+- Revit, ArchiCAD, Vectorworks, BricksCAD, BlenderBIM, … A BIM-authoring tool 🧱
+    > In semio you **link** instances of your own types.
+- Grasshopper, Dynamo, Sverchok, … A *node-based programming* tool 🦗
+    > In semio you **link** the input with the output.
+- Illustrator, AffinityDesigner, InkScape, … A *vector graphics* tool ➡️
+    > In semio you **link** drawings.
+- EnergyPlus, TRYNSIS, Modellica, … A simulation tool ☀️
+    > In semio you **link** models and results.
+- Autodesk Construction Cloud, Bimcloud, Bentley Infrastructure Cloud, Nextcloud, … A cloud tool ☁️
+    > In semio you **link** files acros a folder.
+- IFC, Speckle, BHoM, … A data tool 📄
+    > In semio you **link** design knowledge.
+- Hypar, Victor, Fusion, CadQuery, … A parametric tool 🎛️
+    > In semio you **link** static pieces.
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/conceptual/analogies-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/conceptual/analogies.svg">
-    <img alt="Analogies" src="https://raw.githubusercontent.com/usalu/semio/main/docs/conceptual/analogies.svg">
-</picture>
+So, what **is** semio?
+- An *open-source* ecosystem for designing modular architecture 🧩
+- A *designer-affine* pencil for a placeholder-based, non-linear and iterative design space exploration 🔀
+- A *collaboration-friendly* platform to design effectively in large teams 🤝
+- A *local-first* storage to link, reuse and develop design systems 🔗
+- An *ai-boosted* design assistant, ready for LLM super powers 🤖
+- A *ready-to-use* API for other developers 👩‍💻
 
-semio is an open ecosystem for component-based design of architecture. You can capture and link design knowledge. Preparing for the next generation of AI. In the mean time, automatic file federation enables collaboration, automation and reuse.
+## When should I design with semio?
 
-# Getting started
+If you design storeys, walls, windows, slabs, roofs by moving them around, changing individual dimensions of those, then you should stick to your BIM tool ❌
 
-## Requirements
-- Windows
-- Rhino 7 or greater
+If you design atmospheres based on hand drawn sketches, eager to find the right shape based on surfaces with one-of-each-kind morphology, then you should stick to your 3d tool ❌
 
-semio has currently two user-interfaces. One in Grasshopper and one that is native (sketchpad).
+If you design typologies which you iteratively detail and you want to test systems where you are tinkering about rules and exceptions, then you should use semio ✅
 
-## Installation
+## Are you out of your mind?
 
-The Grasshopper plugin can be installed over the Rhino Package Manager.
-1. Open Rhino Package Manger
-1. Search for semio
-1. Install the latest version
-1. Restart Rhino
+But wait a second, FILES 🤯 We live in the 21. century! Cloud-only object-based level 3 BIM collaboration is so much smoother!
 
-![Rhino Package](https://raw.githubusercontent.com/usalu/semio/main/docs/installation/rhinopackage.gif)
+It is true, you can even follow the cursors of your collegues and see how they pan and scroll 📺
 
-[sketchpad](https://github.com/usalu/semio/releases/download/r24.07-1/engine.zip) needs no installation. Just unpack the folder and run it. If you run sketchpad without Grasshopper then you need to manually download and start the [engine](https://github.com/usalu/semio/releases/download/r24.07-1/engine.zip).
-> NOTE: The binaries are not signed (yet). Therefor Windows might give a warning.
+But are these unique features worth paying the price when designing architecture?
 
-That's it!
+Just to view a design, you suddenly dependen on servers, licenses and companies. Giving up dozens of tools which work on files for editing, sharing, access control, versioning, backups, automation, ...
+
+> In fact, files are the best supported objects in computers 🏆 
 
-## Examples
+Is there really no alternative?
 
-You can download the latest [examples](https://github.com/usalu/semio/releases/download/r24.07-1/examples.zip) or take a look [here](https://github.com/usalu/semio/blob/main/examples/metabolism/README.md).
+Well, if one agent (person or robot) can at most work only on one file, then we need to make sure that not more than one agent works on the same file. 
 
+But how?
 
-# How does semio work?
+We need to set boundaries 🧩
 
->NOTE: This is outdated. Release r23.07 was a complete rewrite. It is way better now!
+> 3d modelling tools have geometry as its units. 
+> BIM tools have building elements as its units.
+> Automation tools have arbitrary structured data as its units. 
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/systemarchitecture/componentsdiagram-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/systemarchitecture/componentsdiagram.svg">
-    <img alt="Components" src="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/systemarchitecture/componentsdiagram.svg">
-</picture>
+It wouldn't make any sense to say that one designer works on one surface, another one on one wall, another one on a json 🐜
 
-semio is an ecosystem of several components. There is a backend that can be extended on different platforms and different frontends for viewing and/or authoring designs. All services including their depenencies are vendored into the platform extensions to run as a binary. Consider the rest as magic.
+How do designers collaborate anyway?
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/metamodel-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/metamodel.svg">
-    <img alt="Metamodel" src="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/metamodel.svg">
-</picture>
+Well, mostly through an architectural concept that turns a design into a system of pieces 🕸️
 
-Here is a brief overview over the process:
+And this is what semio is about. Making the implicit explicit in order create boundaries across files where humans and robots can work together 🚀
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel.svg">
-    <img alt="Process Part 1" src="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel.svg">
-</picture>
+# Getting started
+> Currently the user interfaces are compiled for Windows only.
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel2-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel2.svg">
-    <img alt="Process Part 2" src="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/designprocessmodel2.svg">
-</picture>
+semio has two user-interfaces:
+- Grasshopper 🦗
+- sketchpad ✏️
 
-# Contribution
+> The heart of semio is the `engine.exe` which exposes a GraphQL API. If you are developer, then you should visit `http://localhost:5052/graphql/`.
+
+## Installation
+
+The Grasshopper plugin can be installed over the Rhino Package Manager 🟢
+1. Open Rhino Package Manger ⌨️
+1. Search for semio 🔎
+1. Install the latest version ⬇️
+1. Restart Rhino 🔄
+
+![Rhino Package](https://raw.githubusercontent.com/usalu/semio/main/dotnet/Semio.Grasshopper/docs/rhinopackage.gif)
+
+[sketchpad](https://github.com/usalu/semio/releases/download/r24.08-1/sketchpad.exe) needs no installation. Just unpack the folder and run it. If you run sketchpad without Grasshopper then you need to manually download and start the [engine](https://github.com/usalu/semio/releases/download/r24.08-1/engine.zip) 🏎️
+> NOTE: The binaries are not signed (yet). Therefor Windows might give a warning.
+
+That's it!
+
+# Examples
+
+You can download the latest [examples](https://github.com/usalu/semio/releases/download/r24.08-1/examples.zip) or take a look [here](https://github.com/usalu/semio/blob/main/examples/metabolism/README.md) 👀
 
-<picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/frameworkrelationships-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/frameworkrelationships.svg">
-    <img alt="Components" src="https://raw.githubusercontent.com/usalu/semio/main/docs/softwarequality/softwarearchitecture/frameworkrelationships.svg">
-</picture>
 
 
-If you want to contribute to the project, feel free to open an issue. If you are not sure what your contribution could exactly be, feel free to take a look under the [project site](https://github.com/users/usalu/projects/2) and see if find something.
+# Contribution
+
+New platforms wait to be reached, bugs wait to be found, examples wait to be created, documentation waits to be written, ...
+
+Feel free to open a [discussion](https://github.com/usalu/semio/discussions), an [issue](https://github.com/usalu/semio/issues) or take a look under the [project site](https://github.com/users/usalu/projects/2) 👋