Merge branch 'rel-4.1' of https://github.com/abpframework/abp into rel-4.1

docs/en/PlugIn-Modules.md

@@ -1,3 +1,56 @@
 # Plug-In Modules
 
-TODO
+It is possible to load [modules](Module-Development-Basics.md) as plug-ins. That means you may not reference to a module's assembly in your solution, but you can load that module in the application startup just like any other module.
+
+## Basic Usage
+
+`IServiceCollection.AddApplication<T>()` extension method can get options to configure the plug-in sources.
+
+**Example: Load plugins from a folder**
+
+````csharp
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.DependencyInjection;
+using Volo.Abp.Modularity.PlugIns;
+
+namespace MyPlugInDemo.Web
+{
+    public class Startup
+    {
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddApplication<MyPlugInDemoWebModule>(options =>
+            {
+                options.PlugInSources.AddFolder(@"D:\Temp\MyPlugIns");
+            });
+        }
+
+        public void Configure(IApplicationBuilder app)
+        {
+            app.InitializeApplication();
+        }
+    }
+}
+````
+
+* This is the `Startup` class of a typical ASP.NET Core application.
+* `PlugInSources.AddFolder` gets a folder path and to load assemblies (typically `dll`s) in that folder.
+
+That's all. ABP will discover the modules in the given folder, configure and initialize them just like regular modules.
+
+### Plug-In Sources
+
+`options.PlugInSources` is actually a list of `IPlugInSource` implementations and `AddFolder` is just a shortcut for the following expression:
+
+````csharp
+options.PlugInSources.Add(new FolderPlugInSource(@"D:\Temp\MyPlugIns"));
+````
+
+> `AddFolder()` only looks for the assembly file in the given folder, but not looks for the sub-folders. You can pass `SearchOption.AllDirectories` as a second parameter to explore plug-ins also from the sub-folders, recursively.
+
+There are two more built-in Plug-In Source implementations:
+
+* `PlugInSources.AddFiles()` gets a list of assembly (typically `dll`) files. This is a shortcut of using `FilePlugInSource` class.
+* `PlugInSources.AddTypes()` gets a list of module class types. If you use this, you need to load the assemblies of the modules yourself, but it provides flexibility when needed. This is a shortcut of using `TypePlugInSource` class.
+
+If you need, you can create your own `IPlugInSource` implementation and add to the `options.PlugInSources` just like the others.

docs/zh-Hans/docs-nav.json

@@ -338,53 +338,57 @@
               "path": "Best-Practices/Index.md"
             }
           ]
-        }
-      ]
-    },
-    {
-      "text": "领域驱动设计",
-      "items": [
-        {
-          "text": "概述",
-          "path": "Domain-Driven-Design.md"
         },
         {
-          "text": "领域层",
+          "text": "领域驱动设计",
           "items": [
             {
-              "text": "实体&聚合根",
-              "path": "Entities.md"
-            },
-            {
-              "text": "值对象"
-            },
-            {
-              "text": "仓储",
-              "path": "Repositories.md"
-            },
-            {
-              "text": "领域服务"
+              "text": "概述",
+              "path": "Domain-Driven-Design.md"
             },
             {
-              "text": "规约",
-              "path": "Specifications.md"
-            }
-          ]
-        },
-        {
-          "text": "应用服务层",
-          "items": [
-            {
-              "text": "应用服务",
-              "path": "Application-Services.md"
+              "text": "领域层",
+              "items": [
+                {
+                  "text": "实体&聚合根",
+                  "path": "Entities.md"
+                },
+                {
+                  "text": "值对象"
+                },
+                {
+                  "text": "仓储",
+                  "path": "Repositories.md"
+                },
+                {
+                  "text": "领域服务"
+                },
+                {
+                  "text": "规约",
+                  "path": "Specifications.md"
+                }
+              ]
             },
             {
-              "text": "数据传输对象(DTO)",
-              "path": "Data-Transfer-Objects.md"
+              "text": "应用服务层",
+              "items": [
+                {
+                  "text": "应用服务",
+                  "path": "Application-Services.md"
+                },
+                {
+                  "text": "数据传输对象(DTO)",
+                  "path": "Data-Transfer-Objects.md"
+                },
+                {
+                  "text": "工作单元",
+                  "path": "Unit-Of-Work.md"
+                }
+              ]
             },
             {
-              "text": "工作单元",
-              "path": "Unit-Of-Work.md"
+              "text": "指南: 实现DDD",
+              "path": "Domain-Driven-Design-Implementation-Guide.md"
             }
           ]
         },