Getting started with dotnet try

Setup

Before you get can started creating interactive documentation, you will need to install the following:

Updating to the latest version of the tool is easy. Run the following command:

> dotnet tool update -g Microsoft.dotnet-try

To install the latest preview build from master, first uninstall the existing version of the tool:

> dotnet tool uninstall -g Microsoft.dotnet-try

Then, install from the preview package feed:

> dotnet tool install -g --add-source "https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-tools/nuget/v3/index.json" Microsoft.dotnet-try

You can get started using either one of the options below.

Create a new folder.
cd to your new folder.
Run command dotnet try demo : This will load our interactive dotnet try getting started tutorial.

The tutorials below work you through the following:

Go to the terminal and create a folder called mydoc.
cd to the mydoc folder and create a new console app with the following command:

> dotnet new console -o myApp

This will create a console app with the files myApp.csproj and Program.cs.

Open the mydoc folder in Visual Studio Code.
Create a file called doc.md. Inside that file, add some text and a code fence:

# My Interactive Document:

```cs --source-file ./myApp/Program.cs --project ./myApp/myApp.csproj
```

Now, navigate to the mydoc folder in your console and run the following command:

     > dotnet try

You have created your first C# interactive developer experience. You should now be able to run your console app and see the result in the browser.

Return to README.md