ExtensionManager.VisualStudio.Adapter Readme

Author: loop8ack

ExtensionManager.VisualStudio.Adapter.md

@@ -0,0 +1,24 @@
+# ExtensionManager.VisualStudio.Adapter
+
+The primary goal of these projects is to ensure seamless compatibility with various versions and updates of Visual Studio.
+This aims to reduce the need for frequent updates and maintenance.
+
+## Problems & Solutions
+
+Different versions of Visual Studio, including full and preview versions, come with different internal DLLs.
+Since these DLLs are part of active development, they can vary between versions, posing a challenge not only for supporting the latest updates but also for older versions.
+
+## Solution
+
+The solution relies on generating IL code to create the necessary code according to the differences in various Visual Studio versions.
+This way, the required DLLs only need to be searched for and loaded when the extension is loaded,
+eliminating the need for manual updates and making the extension compatible with older updates as well.
+
+It is crucial that the abstraction is as simple as possible to minimize the complexity of the IL code to be generated.
+
+## Projects
+
+| Project | Description |
+|---|---|
+| ExtensionManager.VisualStudio.Adapter.Abstractions | Contains the abstractions for IL generation. |
+| ExtensionManager.VisualStudio.Adapter.Generator | Contains classes for generating the specific code. |

ExtensionManager.sln

@@ -59,6 +59,9 @@ EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ExtensionManager.VisualStudio.Adapter.Generator", "src\ExtensionManager.VisualStudio.Adapter.Generator\ExtensionManager.VisualStudio.Adapter.Generator.csproj", "{9BACA2E2-713C-42FC-9AA0-A128D48E2D12}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Adapter", "Adapter", "{F180C738-5477-4CE7-9D4A-247BB4E5C1DF}"
+	ProjectSection(SolutionItems) = preProject
+		ExtensionManager.VisualStudio.Adapter.md = ExtensionManager.VisualStudio.Adapter.md
+	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ExtensionManager.VisualStudio.VS2019", "src\ExtensionManager.VisualStudio.VS2019\ExtensionManager.VisualStudio.VS2019.csproj", "{37A5DBB8-C876-4D60-A972-4EC91A857C11}"
 EndProject