## 1. Project Overview & Quickstart (dotnet/wpf) # Windows Presentation Foundation (WPF) [](https://www.dotnetfoundation.org/) [](https://dnceng.visualstudio.com/public/_build/latest?definitionId=270) [](https://codecov.io/gh/dotnet/wpf) [](https://github.com/dotnet/wpf/blob/main/LICENSE.TXT) Windows Presentation Foundation (WPF) is a UI framework for building Windows desktop applications. WPF supports a broad set of application development features, including an application model, resources, controls, graphics, layout, data binding and documents. WPF uses the Extensible Application Markup Language (XAML) to provide a declarative model for application programming. WPF's rendering is vector-based, which enables applications to look great on high DPI monitors, as they can be infinitely scaled. WPF also includes a flexible hosting model, which makes it straightforward to host a video in a button, for example. Visual Studio's designer, as well as Visual Studio Blend, make it easy to build WPF applications, with drag-and-drop and/or direct editing of XAML markup. As of .NET 6.0, WPF supports ARM64. See the [WPF Roadmap](roadmap.md) to learn about project priorities, status and ship dates. [WinForms](https://github.com/dotnet/winforms) is another UI framework for building Windows desktop applications that is supported on .NET (7.0.x/6.0.x). WPF and WinForms applications only run on Windows. They are part of the `Microsoft.NET.Sdk.WindowsDesktop` SDK. You are recommended to use the most recent version of [Visual Studio](https://visualstudio.microsoft.com/downloads/) to develop WPF and WinForms applications for .NET. To build the WPF repo and contribute features and fixes for .NET 8.0, [Visual Studio 2022 Preview](https://visualstudio.microsoft.com/vs/preview/) is required. ## Getting started * [.NET 6.0 SDK](https://dotnet.microsoft.com/download/dotnet/6.0), [.NET 7.0 SDK](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0), [.NET 9.0 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) * [.NET Preview SDKs](https://github.com/dotnet/dotnet/blob/main/docs/builds-table.md) * [Getting started instructions](Documentation/getting-started.md) * [Contributing guide](Documentation/contributing.md) * [Migrating .NET Framework WPF Apps to .NET Core](https://learn.microsoft.com/en-us/dotnet/desktop/wpf/migration/) ## Status - We are currently developing WPF for .NET 10. See the [WPF roadmap](roadmap.md) to learn about the schedule for specific WPF components. Test published at [separate repo](https://github.com/dotnet/wpf-test) Tests and have limited coverage at this time. We will add more tests, however, it will be a progressive process. The Visual Studio WPF designer is now available as part of Visual Studio 2019. ## How to Engage, Contribute and Provide Feedback Some of the best ways to contribute are to try things out, file bugs, join in design conversations, and fix issues. * This repo defines [contributing guidelines](Documentation/contributing.md) and also follows the more general [.NET Core contributing guide](https://github.com/dotnet/runtime/blob/main/CONTRIBUTING.md). * If you have a question or have found a bug, [file an issue](https://github.com/dotnet/wpf/issues/new). * Use [daily builds](Documentation/getting-started.md#installation) if you want to contribute and stay up to date with the team. ### .NET Framework issues Issues with .NET Framework, including WPF, should be filed on [VS developer community](https://developercommunity.visualstudio.com/spaces/61/index.html), or [Product Support](https://support.microsoft.com/en-us/contactus?ws=support). They should not be filed on this repo. ## Relationship to .NET Framework This code base is a fork of the WPF code in the .NET Framework. .NET Core 3.0 was released with a goal of WPF having parity with the .NET Framework version. Over time, the two implementations may diverge. The [Update on .NET Core 3.0 and .NET Framework 4.8](https://devblogs.microsoft.com/dotnet/update-on-net-core-3-0-and-net-framework-4-8/) provides a good description of the forward-looking differences between .NET Core and .NET Framework. This [update](https://devblogs.microsoft.com/dotnet/net-core-is-the-future-of-net/) states how going forward .NET Core is the future of .NET. and .NET Framework 4.8 will be the last major version of .NET Framework. ## Code of Conduct This project uses the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct) to define expected conduct in our community. Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting a project maintainer at conduct@dotnetfoundation.org. ## Reporting security issues and security bugs Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) . You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the [Security TechCenter](https://www.microsoft.com/msrc/faqs-report-an-issue). Also see info about related [Microsoft .NET Core and ASP.NET Core Bug Bounty Program](https://www.microsoft.com/msrc/bounty-dot-net-core). ## License .NET Core (including the WPF repo) is licensed under the [MIT license](LICENSE.TXT). ## .NET Foundation .NET Core WPF is a [.NET Foundation](https://www.dotnetfoundation.org/projects) project. See the [.NET home repo](https://github.com/Microsoft/dotnet) to find other .NET-related projects. ## 2. Official Technical Reference & Guides (dotnet/docs) # .NET Docs [](https://GitHub.com/dotnet/docs/graphs/contributors/) [](https://github.com/dotnet/docs) [](https://GitHub.com/dotnet/docs/issues?q=is%3Aissue+is%3Aopened) [](https://GitHub.com/dotnet/docs/issues?q=is%3Aissue+is%3Aclosed) [](https://GitHub.com/dotnet/docs/pulls?q=is%3Aissue+is%3Aopened) [](https://github.com/dotnet/docs/pulls?q=is%3Apr+is%3Aclosed+is%3Amerged) [](https://github.com/dotnet/docs/pulls?q=is%3Apr+is%3Aclosed+is%3Aunmerged) [](https://www.bestpractices.dev/projects/9215) This repository contains the conceptual documentation for .NET. The [.NET documentation site](https://learn.microsoft.com/dotnet) is built from multiple repositories: - [.NET docs](https://github.com/dotnet/docs) - [ASP.NET Core docs](https://github.com/dotnet/AspNetCore.Docs) - [.NET Desktop workloads docs](https://github.com/dotnet/docs-desktop) - [.NET MAUI docs](https://github.com/dotnet/docs-maui) - [Entity Framework docs](https://github.com/dotnet/EntityFramework.Docs) - [Community toolkit](https://github.com/MicrosoftDocs/communitytoolkit) API reference documentation is published from the following repositories: - [.NET API reference](https://github.com/dotnet/dotnet-api-docs) - [.NET MAUI API reference](https://github.com/dotnet/maui-api-docs) - [Android API reference](https://github.com/dotnet/android-api-docs) - [Entity Framework 6/Core API reference](https://github.com/dotnet/EntityFramework.ApiDocs) - [Roslyn API reference](https://github.com/dotnet/roslyn-api-docs) - [Community toolkit API reference](https://github.com/MicrosoftDocs/community-toolkit-api-ref-dotnet) These API reference doc repositories are public. Only some accept issues and pull requests. Others are pass-through repositories because API reference is generated directly from the `///` in the product source. Some folders in `dotnet-api-docs` use the product repository as the source of truth. The C# language specification documentation comes from the following two repositories: - [C# language design](https://github.com/dotnet/csharplang) - [C# specification - draft](https://github.com/dotnet/csharpstandard) Our team's tasks are tracked in our [project boards](https://github.com/dotnet/docs/projects?query=is%3Aopen). You'll see monthly sprint projects, along with long-running projects for major documentation updates. The projects contain documentation issues across the repositories that build .NET docs. Issues are tracked in the relevant repositories. We have a large community using these resources. We make our best effort to respond to issues in a timely fashion. To create a new issue, click the "Open a documentation issue" button at the bottom of any of our published docs, or [choose one of the available templates](https://github.com/dotnet/docs/issues/new/choose). The control at the bottom of each article automatically routes you to the correct repo and fills in some relevant information based on the article. ## :purple_heart: Contribute We welcome contributions to help us improve and complete the .NET docs. This is a very large repo, covering a large area. If this is your first visit, see the [Contributor guide](https://learn.microsoft.com/contribute/content/dotnet/dotnet-contribute) for information on working with us. Look for issues labeled [`help wanted` :label:](https://github.com/dotnet/docs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22+) for ideas to get started. Before submitting a PR with 3rd party dependencies, see our policy on [3rd party dependencies](admin/3rdPartyDependencies.md). We work to merge or close PRs in a timely fashion. We regularly review and approve PRs. We encourage contributors to respond to comments in a similar timely fashion. Many times, reviews identify small changes such as spelling or grammar issues, or word choice. Maintainers can accept those suggestions and merge the PR. In other situations, maintainers ask for more significant changes before a PR is ready to merge. We expect contributors to make those changes. Maintainers will help by answering questions or pointing to other resources, if needed. We consider PRs to be abandoned when they've had no activity (either commits or discussion) in the past 30 days. Team members will close PRs that have been abandoned. Contributors can reopen and continue to work. ## :bookmark_tabs: Code of conduct This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the [.NET Foundation: Code of Conduct](https://dotnetfoundation.org/code-of-conduct). ## :octocat: GitHub Action workflows - [](https://github.com/dotnet/docs/actions/workflows/live-protection.yml): Adds a comment to PRs that were not automated, but rather manually created that target the `live` branch. - [](https://github.com/dotnet/docs/actions/workflows/dependabot-approve-and-automerge.yml): Automatically approves and auto-merges PRs originating from the `dependabbot[bot]`. - [](https://github.com/dotnet/docs/actions/workflows/whats-new.yml): Creates a PR to generate the "What's new" article on the first of every month. - [](https://github.com/dotnet/docs/actions/workflows/markdownlint.yml): The current status for the entire repositories Markdown linter status. - [](https://github.com/dotnet/docs/actions/workflows/docs-verifier.yml): Runs various Markdown verifications, beyond the linter, such as ensuring links and redirects are valid. - [](https://github.com/dotnet/docs/actions/workflows/check-for-build-warnings.yml): Builds the site for the PR in context, and verifies the build reporting either, `success`, `warnings`, or `error`. - [](https://github.com/dotnet/docs/actions/workflows/snippets5000.yml): Custom .NET build validation, locates code impacted by a PR, and builds. - [](https://github.com/dotnet/docs/actions/workflows/version-sweep.yml): Runs monthly, creating issues on projects that target .NET versions that are out of support. - [](https://github.com/dotnet/docs/actions/workflows/dependabot-bot.yml): Automatically updates the `dependabot` configuration weekly, but only if required. - [](https://github.com/dotnet/docs/actions/workflows/quest.yml): Automatically synchronizes issues with Quest (Azure DevOps). - [](https://github.com/dotnet/docs/actions/workflows/quest-bulk.yml): Manual bulk import of issues into Quest (Azure DevOps).