Replace c#tutorial, phase 1

Author: HeidiSteen

articles/search/TOC.yml

@@ -76,7 +76,9 @@
       - name: Deploy static web app
         href: tutorial-python-deploy-static-web-app.md
       - name: Explore the code
-        href: tutorial-python-search-query-integration.md                
+        href: tutorial-python-search-query-integration.md
+  - name: Add search to ASP.NET Core (MVC)
+    href: tutorial-csharp-create-mvc-app.md             
   - name: Index with indexers
     items:
     - name: Index Azure SQL Database
@@ -105,18 +107,6 @@
     href: tutorial-create-custom-analyzer.md
   - name: Query from Power Apps   
     href: search-howto-powerapps.md
-  - name: Create a C# app
-    items:
-    - name: 1 - Basic search page
-      href: tutorial-csharp-create-first-app.md
-    - name: 2 - Add results paging
-      href: tutorial-csharp-paging.md
-    - name: 3 - Add type-ahead
-      href: tutorial-csharp-type-ahead-and-suggestions.md
-    - name: 4 - Add facets
-      href: tutorial-csharp-facets.md
-    - name: 5 - Add results ordering
-      href: tutorial-csharp-orders.md
 - name: Samples
   items:
   - name: C# samples

articles/search/index-add-suggesters.md

@@ -169,8 +169,6 @@ POST /indexes/myxboxgames/docs/autocomplete?search&api-version=2020-06-30
 
 + [Add search to a web site (JavaScript)](tutorial-javascript-search-query-integration.md#azure-function-suggestions-from-the-catalog) uses an open source Suggestions package for partial term completion in the client app.
 
-+ [Create your first app in C# (lesson 3 - Add search-as-you-type)](tutorial-csharp-type-ahead-and-suggestions.md) sample demonstrates suggested queries, autocomplete, and faceted navigation. This code provides native support for typeahead instead of using a widget.
-
 ## Next steps
 
 Learn more about requests\ formulation.

articles/search/media/search-faceted-navigation/azure-search-facet-nav.png

@@ -54,7 +54,7 @@ Code samples from the Cognitive Search team demonstrate features and workflows.
 | [multiple-data-sources](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/master/multiple-data-sources)  | [Tutorial: Index from multiple data sources](tutorial-multiple-data-sources.md). | Merges content from two data sources into one search index.
 | [Optimize-data-indexing](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/master/optimize-data-indexing) | [Tutorial: Optimize indexing with the push API](tutorial-optimize-indexing-push-api.md).| Demonstrates optimization techniques for pushing data into a search index. |
 | [tutorial-ai-enrichment](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/master/tutorial-ai-enrichment)  | [Tutorial: AI-generated searchable content from Azure blobs](cognitive-search-tutorial-blob-dotnet.md) | Shows how to configure an indexer and skillset. |
-| [Create your first app in C#](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/master/create-first-app/v11) |  [Tutorial: Create your first search app](tutorial-csharp-create-first-app.md) | While most samples are console applications, this MVC sample uses a web page to front the sample Hotels index, demonstrating basic search, pagination, autocomplete and suggested queries, facets, and filters.|
+| [create-mvc-app](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/master/create-mvc-app) |  [Tutorial: Add search to an ASP.NET Core (MVC) app](tutorial-csharp-create-mvc-app.md) | While most samples are console applications, this MVC sample uses a web page to front the sample Hotels index, demonstrating basic search, pagination, and other server-side behaviors.|
 
 ## Other samples
 

articles/search/samples-dotnet.md

@@ -132,7 +132,7 @@ The output of an indexer is a search index, used for interactive exploration usi
 + [Full query syntax](query-lucene-syntax.md)
 + [Filter expression syntax](query-odata-filter-orderby-syntax.md)
 
-A more permanent solution is to gather query inputs and present the response as search results in a client application. The following C# tutorial explains how to build a search application: [Create your first application in Azure Cognitive Search](tutorial-csharp-create-first-app.md).
+A more permanent solution is to gather query inputs and present the response as search results in a client application. The following C# tutorial explains how to build a search application: [Add search to an ASP.NET Core (MVC) application](tutorial-csharp-create-mvc-app.md).
 
 ## Next steps
 

articles/search/search-blob-storage-integration.md

@@ -31,7 +31,7 @@ Facets are dynamic and returned on a query. A search response brings with it all
 
 In Cognitive Search, facets are one layer deep and can't be hierarchical. If you aren't familiar with faceted navigation structured, the following example shows one on the left. Counts indicate the number of matches for each facet. The same document can be represented in multiple facets.
 
-:::image source="media/tutorial-csharp-create-first-app/azure-search-facet-nav.png" alt-text="faceted search results":::
+:::image source="media/search-faceted-navigation/azure-search-facet-nav.png" alt-text="Screenshot of faceted search results.":::
 
 Facets can help you find what you're looking for, while ensuring that you don't get zero results. As a developer, facets let you expose the most useful search criteria for navigating your search index.
 
@@ -287,10 +287,6 @@ If you build the list of facets dynamically based on untrusted user input, valid
 
 Several samples include faceted navigation. This section has links to the samples and also notes which client library and language is used for each one.
 
-### Create your first app in C# (Razor)
-
-This tutorial and sample series in C# includes a [lesson focused on faceted navigation](tutorial-csharp-facets.md). The solution is an ASP.NET MVC app and the presentation layer uses the Razor client libraries.
-
 ### Add search to web apps (React)
 
 Tutorials and samples in [C#](tutorial-csharp-overview.md), [Python](tutorial-python-overview.md), and [JavaScript](tutorial-javascript-overview.md) include faceted navigation as well as filters, suggestions, and autocomplete. These samples use React for the presentation layer.

articles/search/search-faceted-navigation.md

@@ -298,6 +298,6 @@ To quickly generate a search page for your client, consider these options:
 
 + [Application Generator](search-create-app-portal.md), in the portal, creates an HTML page with a search bar, faceted navigation, and results area that includes images.
 
-+ [Create your first app in C#](tutorial-csharp-create-first-app.md) is a tutorial and code sample that builds a functional client. Sample code demonstrates paginated queries, hit highlighting, and sorting.
++ [Add search to an ASP.NET Core (MVC) app](tutorial-csharp-create-mvc-app.md) is a tutorial and code sample that builds a functional client.
 
 + [Add search to web apps](tutorial-csharp-overview.md) is a tutorial and code sample that uses the React JavaScript libraries for the user experience. The app is deployed using Azure Static Web Apps.

articles/search/search-pagination-page-layout.md

@@ -0,0 +1,73 @@
+---
+title: Add search to ASP.NET Core MVC
+titleSuffix: Azure Cognitive Search
+description: In this Azure Cognitive Search tutorial, learn how to add search to an ASP.NET Core (Model-View-Controller) application.
+
+manager: nitinme
+author: HeidiSteen
+ms.author: heidist
+ms.service: cognitive-search
+ms.devlang: csharp
+ms.topic: tutorial
+ms.date: 03/09/2023
+---
+# Create a search app in ASP.NET Core
+
+In this tutorial, create a basic ASP.NET Core (Model-View-Controller) app that connects to the hotels-sample-index on your search service for server-side operations. Search can return sorted, filtered, and boosted results.
+
+Sample code this tutorial can be found in the [azure-search-dotnet-samples](https://github.com/Azure-Samples/azure-search-dotnet-samples/tree/main/create-mvc-app) repository on GitHub. 
+
+## Prerequisites
+
++ [Hotel samples index](search-get-started-portal.md)
++ [Visual Studio](https://visualstudio.microsoft.com/downloads/)
++ [Azure.Search.Documents NuGet package](https://www.nuget.org/packages/Azure.Search.Documents/)
++ [Microsoft.Spatial NuGet package](https://www.nuget.org/packages/Microsoft.Spatial/)
+
+To complete this tutorial, you'll need to create the hotels-sample-index on your search service. Make sure the search index name is`hotels-sample-index`, or change the index name in the `HomeController.cs` file.
+
+Your search service must have public network access. For the connection, the app presents a query API key to your fully-qualified search URL. Both the URL and the query API key are specified in an `appsettings.json` file.
+
+## Set up the project
+
+1. Clone or download this sample repository.
+
+1. Extract contents if the download is a zip file. Make sure the files are read-write.
+
+1. Open the solution in Visual Studio.
+
+1. If necessary, update the NuGet packages to get the most recent stable versions.
+
+1. Modify `appsettings.json` to specify your search service and query API key.
+
+   ```json
+   {
+      "SearchServiceName": "https://<YOUR-SEARCH-SERVICE-NAME>.search.windows.net",
+      "SearchServiceQueryApiKey": "<YOUR-SEARCH-SERVICE-QUERY-API-KEY>"
+   }
+   ```
+
+## Run the sample
+
+1. Press **F5** to compile and run the project. The app runs on local host and opens in your default browser.
+
+1. Select the **Search** button to return all results.
+
+1. This demo uses the default search configuration, supporting the [simple syntax](query-simple-syntax.md) and `searchMode=Any`. You can enter keywords with boolean operators.
+
+1. To change server-side behaviors, modify the **RunQueryAsync** method in the HomeController. There are several use-cases that commented out:
+
+   + Use case 1 is basic search results presented in a table.
+   + Use case 2 adds a filter over the Category field.
+   + Use case 3 adds a sort order over the Rating field.
+
+   Recall that the index field attributes determine which fields are searchable, filterable, sortable, facetable, and retrievable. If you want different filters and sort fields, delete and recreate the hotels index with the attribution necessary for your scenario.
+
+1. Relevance tuning is a server-side operation. If you want to boost the relevance of a document based on whether the match was found in a certain field, such as "Tags", or by location, [add a scoring profile](index-add-scoring-profiles.md) to the hotel-search-index, and then rerun your queries.
+
+## Next steps
+
+If you want to explore client-side operations that respond to user actions, consider adding a React template to your solution:
+
+> [!div class="nextstepaction"]
+> [C# Tutorial: Add search to a website with .NET](tutorial-csharp-overview.md)

articles/search/tutorial-csharp-create-mvc-app.md

@@ -118,8 +118,6 @@ Having a valid key establishes trust, on a per request basis, between the applic
 
 1. In the **Browse** tab, find and then install **Azure.Search.Documents** (version 11.0 or later). 
 
-    :::image type="content" source="media/tutorial-csharp-create-first-app/azure-search-nuget-azure.png" alt-text="Using NuGet to add Azure libraries" border="false":::
-
 1. Search for the **Microsoft.Extensions.Configuration** and **Microsoft.Extensions.Configuration.Json** NuGet packages and install them as well.
 
 1. Open the solution file **/v11/AzureSearchMultipleDataSources.sln**.