try/README.md

# Try .NET <img src ="https://user-images.githubusercontent.com/2546640/56708992-deee8780-66ec-11e9-9991-eb85abb1d10a.png" width="80px" alt="dotnet bot in space" align ="right">
|| [**Contribution Guidelines**](#contribution-guidelines) || [**Table of contents**](#table-of-contents) || [**Customers & Partners**](#customers--partners) ||

![Try_.NET Enabled](https://img.shields.io/badge/Try_.NET-Enabled-501078.svg)


[![Build Status](https://dev.azure.com/dnceng-public/public/_apis/build/status/dotnet/try/try-ci?branchName=main)](https://dev.azure.com/dnceng-public/public/_build?definitionId=62&branchName=main)

## Welcome to the Try .NET repo.

Try .NET provides developers and content authors with tools to create interactive experiences.

There are two different Try .NET interactive experiences:
* The web experience powered by Blazor (as seen on [Microsoft Learn](https://learn.microsoft.com/dotnet/csharp/tour-of-csharp/tutorials/hello-world))
* Interactive documentation with Markdown for .NET Core with the [dotnet try global tool](DotNetTry.md).

### Online, powered by Blazor

Microsoft Learn uses Try .NET to create interactive documentation. Users can run and edit code all in the browser.

_**Please Note**: At the moment, the Try .NET online (`trydotnet.js API`) is currently only used internally at Microsoft as seen on Learn and [.NET page](https://dotnet.microsoft.com/learn/dotnet/in-browser-tutorial/1)._

<img src ="https://user-images.githubusercontent.com/2546640/57144765-c850cc00-6d8f-11e9-982d-50d2b6dc3591.gif" width = "80%">

### Interactive .NET Core documentation with the `dotnet try` global tool

Try .NET enables .NET developers to create interactive markdown files.
To make your markdown files interactive, you will need the [.NET Core 3.0 SDK](https://dotnet.microsoft.com/download/dotnet-core/3.0), the `dotnet try` global tool and [Visual Studio](https://visualstudio.microsoft.com/) / [VS Code](https://code.visualstudio.com/) (or any other editor of your choice).

<img src ="https://user-images.githubusercontent.com/2546640/57158389-47a2c780-6db1-11e9-96ad-8c6e9ab52853.png" width = "80%">

## Table of Contents
- [Getting Started with Try .NET](DotNetTryLocal.md): Interactive documentation generator for .NET Core.


## Contribution Guidelines

As we are still in the early stages of our development, we are unable to take any feature PRs at the moment, but we intend to do so in the future.
If you find an issue or have a feature suggestion, please open an [issue](https://github.com/dotnet/try/issues/new/choose). And if you have any feature suggestions, please submit them using the "community suggestions" label.

## Customers & Partners

**Microsoft Learn**

Microsoft Learn uses [Try .NET](https://learn.microsoft.com/dotnet/csharp/tour-of-csharp/tutorials/hello-world) to create interactive documentation. Users can run and edit .NET code in the browser.

## Community Showcase

**NCache Live by Alachisoft**

[NCache Live](https://www.alachisoft.com/blogs/try-ncache-anywhere-anytime-with-ncache-live/) uses [Try .NET](https://learn.microsoft.com/dotnet/csharp/tour-of-csharp/tutorials/hello-world) to let the user experience NCache APIs with the help of executable and editable .NET code in the browser.