Merge pull request #31 from microsoft/lerich-gettingStartedDocs

Updated Gladstone Overview doc with additional benefit statuses
This commit is contained in:
leslierichardson95 2021-08-10 15:19:56 -07:00 коммит произвёл GitHub
Родитель 7b84288000 770a41d2ac
Коммит ee47a9cdbe
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 4 добавлений и 5 удалений

Просмотреть файл

@ -7,9 +7,9 @@ While the existing model loads extensions in-process, the new extensibility mode
* How to compile and F5 debug an extension with the new model
* Resources and code samples to get started writing an extension with the new model
## Why use the new extensibility model?
## What is the new extensibility model & why should you use it?
The new extensibility model aims to address many of the problems both developers experience when using and writing extensions in Visual Studio using the old model. These issues include:
The new, out-of-proc extensibility model aims to address many of the problems both developers experience when using and writing extensions in Visual Studio using the old model. These issues include:
* Extension-caused crashes and hangs of Visual Studio and other installed extensions
* Inconsistent hard-to-find docs and APIs, tribal knowledge requirements, and overwhelming architecture
@ -20,10 +20,9 @@ Writing extensions using the new model provides the following benefits:
* **Increased reliability** – Extensions written with the new model are out-of-proc and will not block the Visual Studio UI. This means that if the extension crashes, VS will not crash as a result.
* **Reduced API complexity** – The new models wrapper API has been built from the ground-up to be more cohesive and simpler to implement while retaining the old models advanced functionality.
* **Low-trust extensions** – Since extensions in the new model run in a separate process, they can be isolated and ran in a low-trust sandbox. This environment will provide the extensions with read-only access to the file system and controlled writing access via the models APIs.
* **Hot-reloading functionality** – Excluding ones requiring VS component prerequisites that havent been installed yet, extensions written using the new model can be installed and loaded without needing to restart Visual Studio.
* **Low-trust extensions (Coming Soon)** – Since extensions in the new model run in a separate process, they can be isolated from devenv and ran in a low-trust sandbox. This environment will provide the extensions with read-only access to the file system and controlled writing access via the models APIs.
* **Hot-reloading functionality (Coming Soon)** – Excluding ones requiring VS component prerequisites that havent been installed yet, extensions written using the new model can be installed and loaded without needing to restart Visual Studio.
* **.NET Core Only** – With VS transitioning primarily to .NET core, all new model extensions will be run on .NET core. All APIs will also be built on .NET core and will be .NET 6 compatible.
* **Cross-compatibility with Visual Studio for Mac** – Extensions written with the new model will be compatible with both VS Windows and VS for Mac.
* **Cross-CPU Platform** – Since APIs will be IServiceBroker and .NET core based, all Gladstone extensions will run on all CPU platforms supported by .net core runtime.
## Next Steps