Documentation/README.md

# 👋 Welcome

Welcome to **Avalonia Docs**! 

Learn how to create .NET GUI applications for Windows, macOS, Linux, iOS, Android and Web Assembly from a single codebase. 

## Supported .NET Version

Avalonia is supported on [all platforms that support .NET Standard 2.0](https://github.com/dotnet/standard/blob/release/3.0/docs/versions/netstandard2.0.md#platform-support)

## Supported Platforms

Avalonia is supported on the following platforms:

* Windows 8 and higher
  * **Note**: Avalonia works correctly on Windows 7 also, but not supported _officially_
* MacOS High Sierra 10.13 and higher
* for Linux:
  * Debian 9 (Stretch) and higher
  * Ubuntu 16.5 and higher
  * Fedora 30 and higher

## Supported Development Environments

The following environments support Avalonia XAML with IntelliSense:

* Visual Studio 2017 and higher (with or without Resharper 2020.3). Avalonia Visual Designer is also supported.
* JetBrains Rider 2020.3 and higher.

[Installing Avalonia Extension for Visual Studio](docs/getting-started/ide-support/)

[JetBrains Rider Setup](docs/getting-started/ide-support/jetbrains-rider-setup.md)

## How to get help

### Community Support 
If you've found a bug or issue in the framework, you should create an issue on [GitHub](https://github.com/AvaloniaUI/Avalonia). 

If you're looking for help with your app, try engaging our active developer community on [Telegram](https://t.me/Avalonia). 

### Commerical Support 
We have a range of commercial support plans that provide priority assistance from the core contributors. You can learn more from [our website](https://avaloniaui.net/support.html).
GitBook: [#135] Change "Why Avalonia is a Hit" to "Why Choose Avalonia" 2022-01-05 16:26:46 +03:00			`# 👋 Welcome`
GitBook: [master] 172 pages and 20 assets modified 2021-04-25 22:05:46 +03:00
Update README.md 2022-04-29 18:05:49 +03:00			`Welcome to Avalonia Docs!`
upd 2021-10-21 14:59:23 +03:00
Removing the marketing blurb from the welcome page. I'd like to keep docs focused on helping developers rather than convincing them. 2022-04-28 14:51:58 +03:00			`Learn how to create .NET GUI applications for Windows, macOS, Linux, iOS, Android and Web Assembly from a single codebase.`
feat(Doc):Add Runtime Requirements (#96) * feat(Doc):Add Runtime Requirements Migrated Runtime Requirements from https://github.com/AvaloniaUI/Avalonia/wiki/Runtime-Requirements * fixes(Doc): Missing remove tag 2021-09-10 21:11:03 +03:00
Update README.md 2021-10-20 16:14:50 +03:00			`## Supported .NET Version`
GitBook: [master] 172 pages and 20 assets modified 2021-04-25 22:05:46 +03:00
README: fix stale .NET Standard link The "master" branch on https://github.com/dotnet/standard does not exist anymore. Github redirects that link to the current default branch "archive". But since the expected file does not exist on that branch, users are faced with a 404 page. Link to the "release/3.0" branch instead, which seems to have the latest version of the document. 2022-03-09 20:52:22 +03:00			`Avalonia is supported on [all platforms that support .NET Standard 2.0](https://github.com/dotnet/standard/blob/release/3.0/docs/versions/netstandard2.0.md#platform-support)`
GitBook: [master] 5 pages and 4 assets modified 2021-09-16 12:31:00 +03:00
Update README.md 2021-10-20 16:14:50 +03:00			`## Supported Platforms`

			`Avalonia is supported on the following platforms:`

			`* Windows 8 and higher`
typo fixes and slight readability improvements 2022-01-05 20:02:36 +03:00			`* Note: Avalonia works correctly on Windows 7 also, but not supported _officially_`
			`* MacOS High Sierra 10.13 and higher`
Update README.md 2021-10-20 16:14:50 +03:00			`* for Linux:`
GitBook: [#135] Change "Why Avalonia is a Hit" to "Why Choose Avalonia" 2022-01-05 16:26:46 +03:00			`* Debian 9 (Stretch) and higher`
Update README.md 2021-10-20 16:14:50 +03:00			`* Ubuntu 16.5 and higher`
			`* Fedora 30 and higher`

			`## Supported Development Environments`

upd 2021-10-21 17:32:42 +03:00			`The following environments support Avalonia XAML with IntelliSense:`
Update README.md 2021-10-20 16:14:50 +03:00
GitBook: [#135] Change "Why Avalonia is a Hit" to "Why Choose Avalonia" 2022-01-05 16:26:46 +03:00			`* Visual Studio 2017 and higher (with or without Resharper 2020.3). Avalonia Visual Designer is also supported.`
upd 2021-10-21 18:23:56 +03:00			`* JetBrains Rider 2020.3 and higher.`
Update README.md 2021-10-20 16:14:50 +03:00
GitBook: [#135] Change "Why Avalonia is a Hit" to "Why Choose Avalonia" 2022-01-05 16:26:46 +03:00			`[Installing Avalonia Extension for Visual Studio](docs/getting-started/ide-support/)`
upd 2021-10-21 18:29:54 +03:00
upd 2021-10-21 18:23:56 +03:00			`[JetBrains Rider Setup](docs/getting-started/ide-support/jetbrains-rider-setup.md)`
Removing the marketing blurb from the welcome page. I'd like to keep docs focused on helping developers rather than convincing them. 2022-04-28 14:51:58 +03:00
			`## How to get help`

			`### Community Support`
			`If you've found a bug or issue in the framework, you should create an issue on [GitHub](https://github.com/AvaloniaUI/Avalonia).`

			`If you're looking for help with your app, try engaging our active developer community on [Telegram](https://t.me/Avalonia).`

			`### Commerical Support`
			`We have a range of commercial support plans that provide priority assistance from the core contributors. You can learn more from [our website](https://avaloniaui.net/support.html).`