Document: Working with ABP Suite

en/studio/working-with-suite.md

@@ -1,3 +1,33 @@
 # ABP Studio: Working with ABP Suite
 
-*TODO*
+ABP Studio (Studio) has a shortcut for running ABP Suite (Suite) to allow using it without starting it externally and using it on a browser. Thus you can use both Studio and Suite as a united platform.
+
+## Running Suite From Studio
+
+### Opening from main window
+
+The `ABP Suite` button runs the Suite and opens it as a tab in the main page of Studio. It may take a few seconds to open Suite if it is not already running. The main page of Suite will be shown if there is not a module loaded in Studio. Otherwise, it will automatically open `Crud Page Generation` screen with the loaded module in Studio.
+
+![suite-button-main-page](./images/suite/suite-button-main-page.png)
+
+![suite-main-page](./images/suite/suite-main-page.png)
+
+If There are more than one module which is openable via Suite, Studio will ask you to pick one of them before opening it. If you select a module, Suite will automatically open `Crud Page Generation` screen with the selected module. If you choose `Continue without selecting a module`, Suite main page will be opened.
+
+![suite-pick-module-window](./images/suite/suite-pick-module-window.png)
+
+
+
+### Opening from context menu
+
+Alternatively, you can right click to a module in `Solution Explorer` and click `ABP Suite` to open it with Suite. Suite will automatically open `Crud Page Generation` screen with the selected module.
+
+![suite-context-menu](./images/suite/suite-context-menu.png)
+
+## Supported Templates
+
+Standard application solutions (`App` & `App-nolayers`)  generated by Studio are fully supported by Suite.
+
+### Generating code on  the microservice Template
+
+You can generate code on the services of the microservice solution. UI code generation is not supported at the moment. It is on the roadmap.