start quickstart skeleton

Signed-off-by: Hannah Hunter <hannahhunter@microsoft.com>
2025-01-17 11:12:44 -05:00 · 2025-01-17 11:12:44 -05:00 · 9d8cad1f99
parent d0d425f54f
commit 9d8cad1f99
1 changed files with 151 additions and 0 deletions
--- a/daprdocs/content/en/getting-started/quickstarts/conversation-quickstart.md
+++ b/daprdocs/content/en/getting-started/quickstarts/conversation-quickstart.md
@ -0,0 +1,151 @@
+---
+type: docs
+title: "Quickstart: Conversation"
+linkTitle: Conversation
+weight: 90
+description: Get started with the Dapr conversation building block
+---
+
+{{% alert title="Alpha" color="warning" %}}
+The conversation building block is currently in **alpha**. 
+{{% /alert %}}
+
+Let's take a look at the [Dapr conversation building block]({{< ref conversation-overview.md >}}), which 
+
+You can try out this conversation quickstart by either:
+
+- [Running all applications in this sample simultaneously with the Multi-App Run template file]({{< ref "#run-using-multi-app-run" >}}), or
+- [Running one application at a time]({{< ref "#run-one-job-application-at-a-time" >}})
+
+## Run using Multi-App Run
+
+Select your preferred language-specific Dapr SDK before proceeding with the Quickstart. Currently, you can experiment with the conversation API with the Go SDK.
+
+{{< tabs ".NET" >}}
+
+ <!-- .NET -->
+{{% codetab %}}
+
+This quickstart includes two apps:
+
+### Step 1: Pre-requisites
+
+For this example, you will need:
+
+- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started).
+- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download).
+<!-- IGNORE_LINKS -->
+- [Docker Desktop](https://www.docker.com/products/docker-desktop)
+<!-- END_IGNORE -->
+
+### Step 2: Set up the environment
+
+Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation).
+
+```bash
+git clone https://github.com/dapr/quickstarts.git
+```
+
+From the root of the Quickstarts directory, navigate into the conversation directory:
+
+```bash
+cd conversation/csharp/sdk
+```
+
+### Step 3: 
+
+Run the application and schedule conversation with one command:
+
+```bash
+dapr run -f .
+```
+
+**Expected output**
+
+Once the process has completed, you can stop and clean up application processes with a single command.
+
+```bash
+dapr stop -f .
+```
+
+### What happened?
+
+When you ran `dapr init` during Dapr install:
+
+Running `dapr run -f .` in this Quickstart... 
+
+#### `dapr.yaml` Multi-App Run template file
+
+Running the [Multi-App Run template file]({{< ref multi-app-dapr-run >}}) with `dapr run -f .` starts all applications in your project. In this Quickstart, the `dapr.yaml` file contains the following:
+
+```yml
+```
+
+#### `conversation` app
+
+```csharp
+
+```
+
+{{% /codetab %}}
+
+{{< /tabs >}}
+
+## Run one job application at a time
+
+{{< tabs ".NET" >}}
+
+ <!-- .NET -->
+{{% codetab %}}
+
+
+### Step 1: Pre-requisites
+
+For this example, you will need:
+
+- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started).
+- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download).
+<!-- IGNORE_LINKS -->
+- [Docker Desktop](https://www.docker.com/products/docker-desktop)
+<!-- END_IGNORE -->
+
+### Step 2: Set up the environment
+
+Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation).
+
+```bash
+git clone https://github.com/dapr/quickstarts.git
+```
+
+From the root of the Quickstarts directory, navigate into the conversation directory:
+
+```bash
+cd conversation/csharp/sdk
+```
+
+### Step 3: 
+
+
+
+{{% /codetab %}}
+
+{{< /tabs >}}
+
+
+## Watch the demo
+
+See the conversation API in action using a .NET example.
+
+## Tell us what you think!
+
+We're continuously working to improve our Quickstart examples and value your feedback. Did you find this Quickstart helpful? Do you have suggestions for improvement?
+
+Join the discussion in our [discord channel](https://discord.com/channels/778680217417809931/953427615916638238).
+
+## Next steps
+
+- SDK samples of this quickstart:
+  - [.NET](https://github.com/dapr/quickstarts/tree/master/conversation/go/http)
+- Learn more about [the conversation building block]({{< ref conversation-overview.md >}})
+
+{{< button text="Explore Dapr tutorials  >>" page="getting-started/tutorials/_index.md" >}}