Merge main into feature/qep2

.gitignore

@@ -24,7 +24,7 @@ bld/
 [Oo]bj/
 [Ll]og/
 [Dd]rops/
-**/qir-gen.ll
+[Dd]ocs/
 
 # Visual Studio 2015/2017 cache/options directory
 .vs/

AdvantageBenchmark/privateBuild/host.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.Quantum.Sdk/0.15.2103130749-beta">
+<Project Sdk="Microsoft.Quantum.Sdk">
   <!-- Add project references to Simulator and other required packages: -->
   <Import Project="..\..\src\Simulation\Common\Simulators.Dev.props" />
 

AdvantageBenchmark/releasedBuild/quantum/quantum.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.Quantum.Sdk/0.15.2103130749-beta">
+<Project Sdk="Microsoft.Quantum.Sdk">
 
   <ItemGroup>
     <QSharpCompile Include="..\..\privateBuild\quantum.qs" />

CONTRIBUTING.md

@@ -3,7 +3,7 @@
 Welcome, and thank you for your interest in contributing to Q#!
 
 There are many ways in which you can contribute, beyond writing code. The goal of this document is to provide a high-level overview of how you can get involved.
-For more details on how to contribute to Q# or the rest of the Quantum Development Kit, please see the [contribution guide](https://docs.microsoft.com/quantum/contributing/).
+For more details on how to contribute to Q# or the rest of the Quantum Development Kit, please see the [contribution guide](https://docs.microsoft.com/azure/quantum/contributing-overview).
 
 ## Asking Questions
 
@@ -18,7 +18,7 @@ Have a feature request?
 We want to hear about it!
 Here's how you can make reporting your issue as effective as possible.
 
-The Quantum Development Kit is distributed across multiple repositories. Filing an issue against the correct repository will help address it swiftly. Check the list [in the contribution guide](https://docs.microsoft.com/quantum/contributing/#where-do-contributions-go) to figure out which repo is a good place to file it.
+The Quantum Development Kit is distributed across multiple repositories. Filing an issue against the correct repository will help address it swiftly. Check the list [in the contribution guide](https://docs.microsoft.com/azure/quantum/contributing-overview#where-do-contributions-go) to figure out which repo is a good place to file it.
 You can follow the [template](https://github.com/microsoft/qsharp-runtime/issues/new?assignees=&labels=bug&template=bug_report.md&title=) for reporting issues on this repository. 
 
 
@@ -43,7 +43,7 @@ please file one following the [feature request template](https://github.com/micr
 We will respond to feature requests and follow up with a discussion around its feasibility, 
 how one might go about implementing it, and whether that is something we would consider adding to our repo. 
 There are several reasons why we might not be able to eventually merge even a great feature for one reason or another. 
-Take a look at our general contribution guide for [reasons why this might be the case](https://docs.microsoft.com/quantum/contributing/code#when-well-reject-a-pull-request). 
+Take a look at our general contribution guide for [reasons why this might be the case](https://docs.microsoft.com/azure/quantum/contributing-code#when-well-reject-a-pull-request). 
 Even if we are not able to incorporate something into the packages and extensions we distribute, 
 we encourage you to pursue your passion project in your own fork, 
 and share and discuss your thoughts and progress on the corresponding issue. 
@@ -53,12 +53,12 @@ search for example for the [good-first-issue](https://github.com/microsoft/qshar
 Also, look for issues that have already been discussed in more detail, 
 and check if you can help someone who has already started working on it. 
 
-Whether you want to help fixing bugs or add new features, please take a look at our general guide for [Contributing Code](https://docs.microsoft.com/quantum/contributing/code).
+Whether you want to help fixing bugs or add new features, please take a look at our general guide for [Contributing Code](https://docs.microsoft.com/azure/quantum/contributing-code).
 
 ## Contributing Documentation
 
 If you are interested in contributing to conceptual documentation about Q#, please see the [MicrosoftDocs/quantum-docs-pr](https://github.com/MicrosoftDocs/quantum-docs-pr) repository.
-If you are interested in contributing API references, please see [Contributing Code](https://docs.microsoft.com/quantum/contributing/code) in the contribution guide.
+If you are interested in contributing API references, please see [Contributing Code](https://docs.microsoft.com/azure/quantum/contributing-code) in the contribution guide.
 
 And last but not least:
 

README.md

@@ -2,7 +2,7 @@
 
 Welcome to the Microsoft Quantum Development Kit!
 
-This repository contains the runtime components for the [Quantum Development Kit](https://docs.microsoft.com/quantum/).
+This repository contains the runtime components for the [Quantum Development Kit](https://docs.microsoft.com/azure/quantum/).
 It consists of the libraries and packages needed to create and simulate quantum applications using Q#.
 
 - **[Azure/](./src/Azure/)**: Source for client package to create and manage jobs in Azure Quantum.
@@ -11,14 +11,14 @@ It consists of the libraries and packages needed to create and simulate quantum
 
 ## New to Quantum? ##
 
-See the [introduction to quantum computing](https://docs.microsoft.com/quantum/concepts/) provided with the Quantum Development Kit.
+See the [introduction to quantum computing](https://docs.microsoft.com/azure/quantum/concepts-overview) provided with the Quantum Development Kit.
 
 
 ## Installing the Quantum Development Kit
 
-**If you're looking to use Q# to write quantum applications, please see the instructions on how to get started with using the [Quantum Development Kit](https://docs.microsoft.com/quantum/install-guide/) including the Q# compiler, language server, and development environment extensions.**
+**If you're looking to use Q# to write quantum applications, please see the instructions on how to get started with using the [Quantum Development Kit](https://docs.microsoft.com/azure/quantum/install-overview-qdk) including the Q# compiler, language server, and development environment extensions.**
 
-Please see the [installation guide](https://docs.microsoft.com/quantum/install-guide) for further information on how to get started using the Quantum Development Kit to develop quantum applications.
+Please see the [installation guide](https://docs.microsoft.com/azure/quantum/install-overview-qdk) for further information on how to get started using the Quantum Development Kit to develop quantum applications.
 You may also visit our [Quantum](https://github.com/microsoft/quantum) repository, which offers a wide variety of samples on how to write quantum based programs.
 
 
@@ -28,7 +28,7 @@ You may also visit our [Quantum](https://github.com/microsoft/quantum) repositor
 
 Note that when building from source, this repository is configured so that .NET Core will automatically look at the [Quantum Development Kit prerelease feed](https://dev.azure.com/ms-quantum-public/Microsoft%20Quantum%20(public)/_packaging?_a=feed&feed=alpha) in addition to any other feeds you may have configured.
 
-Building **QIR Runtime** isn't enabled by default yet. Please see [its readme](./src/QirRuntime/README.md) for details.
+Building **QIR Runtime** isn't enabled by default yet. Please see [its readme](./src/Qir/Runtime/README.md) for details.
 
 ### Windows ###
 
@@ -57,6 +57,28 @@ To build on other platforms:
 1. Install the pre-reqs:
     * Install [CMake](https://cmake.org/install/)
     * Install [.NET Core 3 SDK](https://dotnet.microsoft.com/download)
+    * On [WSL](https://docs.microsoft.com/en-us/windows/wsl/)/Linux:
+      * Install `g++` (e.g. in Ubuntu 20.04 `sudo apt-get install g++`).
+      * The build does not accept `dotnet-*-5.0` packages, install `dotnet-*-3.1`
+        (`sudo apt-get install dotnet-sdk-3.1`). The possible result can be:
+
+```sh
+qsharp-runtime$ dpkg -l *dotnet*
+Desired=Unknown/Install/Remove/Purge/Hold
+| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
+|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
+||/ Name                      Version      Architecture Description
++++-=========================-============-============-=================================================================
+un  dotnet                    <none>       <none>       (no description available)
+ii  dotnet-apphost-pack-3.1   3.1.13-1     amd64        Microsoft.NETCore.App.Host 3.1.13
+ii  dotnet-host               5.0.4-1      amd64        Microsoft .NET Host - 5.0.4
+ii  dotnet-hostfxr-3.1        3.1.13-1     amd64        Microsoft .NET Core Host FX Resolver - 3.1.13 3.1.13
+un  dotnet-nightly            <none>       <none>       (no description available)
+ii  dotnet-runtime-3.1        3.1.13-1     amd64        Microsoft .NET Core Runtime - 3.1.13 Microsoft.NETCore.App 3.1.13
+ii  dotnet-runtime-deps-3.1   3.1.13-1     amd64        dotnet-runtime-deps-3.1 3.1.13
+ii  dotnet-sdk-3.1            3.1.407-1    amd64        Microsoft .NET Core SDK 3.1.407
+ii  dotnet-targeting-pack-3.1 3.1.0-1      amd64        Microsoft.NETCore.App.Ref 3.1.0
+```
 2. Run [bootstrap.ps1](./bootstrap.ps1)
     * The script might install additional tools (a specific compiler, build tools, etc)
     * Then it builds release flavor of the native (C++) full-state simulator and debug flavor of the Simulation solution.
@@ -81,7 +103,7 @@ All unit tests are part of the `Simulation.sln` solution. To run the tests:
 ## Feedback ##
 
 If you have feedback about the Q# simulators or any other runtime component, please let us know by filing a [new issue](https://github.com/microsoft/qsharp-runtime/issues/new)!
-If you have feedback about some other part of the Microsoft Quantum Development Kit, please see the [contribution guide](https://docs.microsoft.com/quantum/contributing/) for more information.
+If you have feedback about some other part of the Microsoft Quantum Development Kit, please see the [contribution guide](https://docs.microsoft.com/azure/quantum/contributing-overview) for more information.
 
 
 ## Reporting Security Issues
@@ -111,4 +133,4 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
-For more details, please see [CONTRIBUTING.md](./CONTRIBUTING.md), or the [contribution guide](https://docs.microsoft.com/quantum/contributing/).
+For more details, please see [CONTRIBUTING.md](./CONTRIBUTING.md), or the [contribution guide](https://docs.microsoft.com/azure/quantum/contributing-overview).