WCF to gRPC include /2 (dotnet#36565)

* WCF to gRPC include /2 * WCF to gRPC include /2 * WCF to gRPC include /2 * WCF to gRPC include /2 * WCF to gRPC include /2 * WCF to gRPC include /2 * WCF to gRPC include /2
ardalis · Aug 9, 2023 · 1b3321c · 1b3321c
1 parent 8a81cbc
commit 1b3321c
Show file tree

Hide file tree

Showing 7 changed files with 24 additions and 0 deletions.
diff --git a/docs/framework/wcf/feature-details/hosting.md b/docs/framework/wcf/feature-details/hosting.md
@@ -32,5 +32,6 @@ The topics in the section describe service hosting. A service can be hosted by I
 
 ## See also
 
+- [!INCLUDE[](~/includes/wcf_grpc.md)]
 - [Hosting Services](../hosting-services.md)
 - [Windows Server App Fabric Hosting Features](/previous-versions/appfabric/ee677189(v=azure.10))
diff --git a/docs/framework/wcf/getting-started-tutorial.md b/docs/framework/wcf/getting-started-tutorial.md
@@ -18,6 +18,8 @@ For sample WCF applications that you can download and run, see [Windows Communic
 
 For more in-depth information about creating services and clients, see [Basic WCF programming](basic-wcf-programming.md).
 
+[!INCLUDE[](~/includes/wcf_grpc_heading.md)]
+
 ## WCF tutorials
 
 The first three tutorials describe how to define a WCF service contract, how to implement it, and how to host it. The service that you create is self-hosted within a console application. You can also host services under Microsoft Internet Information Services (IIS). For more information, see [How to: Host a WCF Service in IIS](feature-details/how-to-host-a-wcf-service-in-iis.md). Although you use code to configure the service in the tutorial, you can also [configure services within a configuration file](configuring-services-using-configuration-files.md).

diff --git a/docs/framework/wcf/wcf-simplification-features.md b/docs/framework/wcf/wcf-simplification-features.md
@@ -9,6 +9,8 @@ ms.assetid: 4535a511-6064-4da0-b361-80262a891663
 
 This topic discusses new features that make writing WCF applications simpler.
 
+[!INCLUDE[](~/includes/wcf_grpc_heading.md)]
+
 ## Simplified Generated Configuration Files
 
 When you add a service reference in Visual Studio or use the SvcUtil.exe tool a client configuration file is generated. In previous versions of WCF these configuration files contained the value of every binding property even if its value is the default value. In WCF 4.5 the generated configuration files contain only those binding properties that are set to a non-default value.

diff --git a/docs/framework/wcf/whats-new.md b/docs/framework/wcf/whats-new.md
@@ -12,6 +12,8 @@ ms.assetid: 7e93fe73-af93-46b5-9f63-32f761ee40cf
 
 This topic discusses features new to Windows Communication Foundation (WCF) version 4.5.
 
+[!INCLUDE[](~/includes/wcf_grpc_heading.md)]
+
 ## WCF Simplification Features
 
 Much work has been done to make WCF 4.5 applications easier to develop and maintain. For more information, see [WCF Simplification Features](wcf-simplification-features.md).

diff --git a/docs/framework/wcf/whats-wcf.md b/docs/framework/wcf/whats-wcf.md
@@ -24,6 +24,8 @@ Windows Communication Foundation (WCF) is a framework for building service-orien
 
 While creating such applications was possible prior to the existence of WCF, WCF makes the development of endpoints easier than ever. In summary, WCF is designed to offer a manageable approach to creating Web services and Web service clients.
 
+[!INCLUDE[](~/includes/wcf_grpc_heading.md)]
+
 ## Features of WCF
 
 WCF includes the following set of features. For more information, see [WCF Feature Details](./feature-details/index.md).

diff --git a/includes/wcf_grpc.md b/includes/wcf_grpc.md
@@ -0,0 +1,12 @@
+gRPC is a modern RPC framework that is a popular alternative to WCF. gRPC is built on top of HTTP/2, which provides a number of advantages over WCF, including:
+
+* Performance: gRPC is much more efficient than WCF, especially for long-running connections.
+* Scalability: gRPC is designed to scale to large numbers of clients and servers.
+* Security: gRPC supports a variety of security mechanisms, including TLS and authentication.
+* Cross-platform: gRPC is platform-neutral and can be used with a variety of programming languages.
+
+For more information on developing or migrating WCF apps to gRPC, see:
+
+* [Why we recommend gRPC for WCF developers](/dotnet/architecture/grpc-for-wcf-developers/why-grpc)
+* [Comparing WCF to gRPC](/dotnet/architecture/grpc-for-wcf-developers/wcf-services-to-grpc-comparison)
+* [Introduction to gRPC for WCF developers](/dotnet/architecture/grpc-for-wcf-developers/introduction)
diff --git a/includes/wcf_grpc_heading.md b/includes/wcf_grpc_heading.md
@@ -0,0 +1,3 @@
+## gRPC as an alternative to WCF
+
+[!INCLUDE[](~/includes/wcf_grpc.md)]
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		## gRPC as an alternative to WCF

		[!INCLUDE[](~/includes/wcf_grpc.md)]