Publish recent changes

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+    "recommendations": [
+        // Suggest that users have the MS Docs Authoring Pack, which provides
+        // a number of tools for working with DocFX-based documentation repos.
+        "docsmsft.docs-authoring-pack"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+    "markdownlint.config": {
+        "default": true,
+        // Use #-style section headings without the ending # marks, as that can
+        // cause problems working with the Samples Browser.
+        "MD003": {"style": "atx"},
+        "MD013": false
+    }
+}

api/docfx.json

@@ -39,15 +39,7 @@
     "overwrite": [],
     "externalReference": [],
     "globalMetadata": {
-      "latex_macros": {
-        "ket": ["\\left| #1\\right\\rangle", 1],
-        "bra": ["\\left\\langle #1\\right|", 1],
-        "braket": ["\\left\\langle #1 \\right\\rangle", 1],
-        "boldone": "\\mathbf{1}",
-        "expect": "\\mathbb{E}",
-        "variance": "\\operatorname{Var}",
-        "defeq": "\\mathrel{:=}"
-      },
+      "show_latex": true,
       "ms.prod": "quantum",
       "ms.topic": "managed-reference",
       "ms.devlang":"qsharp",
@@ -57,7 +49,21 @@
       "feedback_product_url": "https://github.com/microsoft/quantum/issues",
       "titleSuffix": "Q# reference - Microsoft Quantum"
     },
-    "fileMetadata": {},
+    "fileMetadata": {
+      "latex_macros": {
+        "**/**.yml": {
+          "ket": ["\\left| #1\\right\\rangle", 1],
+          "bra": ["\\left\\langle #1\\right|", 1],
+          "braket": [ "\\left\\langle #1 \\right\\rangle", 1 ],
+          "id": "\\mathbb{1}",
+          "boldone": "\\mathbf{1}",
+          "expect": "\\mathbb{E}",
+          "variance": "\\operatorname{Var}",
+          "defeq": "\\mathrel{:=}",
+          "dd": "\\mathrm{d}"
+        }
+      }
+    },
     "template": [],
     "dest": "quantum-api"
   }

articles/Glossary.md

@@ -36,7 +36,6 @@ uid: microsoft.quantum.glossary
 |Quantum State|A representation of the qubits in the system. This is usually denoted as a complex column vector. For more information, see <xref:microsoft.quantum.concepts.vectors>. |
 |Qubit|Unit of quantum storage. See the <xref:microsoft.quantum.concepts.qubit> section for more details.|
 |Repeat-until-success|A quantum algorithm that probabilistically succeeds. Upon failure, the routine will re-try until successful (or a limit has been reached). |
-|Software Stack|The complete set of classical and quantum software as well as the compilers, simulators and runtimes necessary to operate a quantum computer. See the <xref:microsoft.quantum.concepts.software-stack> section for more details. |
 |Target machine|A compilation target that lowers an abstract quantum program towards hardware or simulation. This typically include re-writes for many purposes including gate replacement, encoding for error correction, geometric layout and others.|
 |Tuple|Comma separated types grouped together via parenthesis. |
 |User-defined type|Collection of built-in or previously defined types that may be referred to as a single unit.|

articles/TOC.yml

@@ -29,7 +29,15 @@
 - name: How-to guides
   items:
   - name: Install the QDK
-    href: install-guide/index.md
+    items:
+    - name: Installation overview
+      href: install-guide/index.md
+    - name: Q# + C#
+      href: install-guide/csinstall.md
+    - name: Q# + Python
+      href: install-guide/pyinstall.md
+    - name: Q# Jupyter notebooks
+      href: install-guide/qjupyter.md
   - name: Update the QDK
     href: install-guide/update.md  
   - name: Create a Q# project

articles/concepts/circuits.md

@@ -34,7 +34,7 @@ For example, the symbol
 <!-- Can't find a way to easily center this... probably an extension needed:  -->
 ![](~/media/concepts_2.png)
 
-is the [Hadamard](xref:microsoft.quantum.primitive.h) gate acting on a single-qubit register.
+is the [Hadamard](xref:microsoft.quantum.intrinsic.h) gate acting on a single-qubit register.
 
 Quantum gates are ordered in chronological order with the left-most gate as the gate first applied to the qubits.
 In other words, if you picture the wires as holding the quantum state, the wires bring the quantum state through each of the gates in the diagram from left to right.
@@ -77,7 +77,7 @@ In general, we describe such controlled operations in circuit diagrams as
 ![](~/media/concepts_5.png)
 
 Here the black circle denotes the quantum bit on which the gate is controlled and a vertical wire denotes the unitary that is applied when the control qubit takes the value $1$.
-For the special cases where $G=X$ and $G=Z$ we introduce the following notation to describe the controlled version of the gates (note that the controlled-X gate is the [$CNOT$ gate](xref:microsoft.quantum.primitive.cnot)):
+For the special cases where $G=X$ and $G=Z$ we introduce the following notation to describe the controlled version of the gates (note that the controlled-X gate is the [$CNOT$ gate](xref:microsoft.quantum.intrinsic.cnot)):
 
 <!--- ![](.\media\6.svg) --->
 <!-- Can't find a way to easily center this... probably an extension needed:  -->
@@ -102,7 +102,7 @@ Specifically, such a subcircuit looks like:
 <!-- Can't find a way to easily center this... probably an extension needed:  -->
 ![Measurement circuit](~/media/concepts_7.png)
 
-Q# implements a [Measure operator](xref:microsoft.quantum.primitive.measure) for this purpose.
+Q# implements a [Measure operator](xref:microsoft.quantum.intrinsic.measure) for this purpose.
 See the [section on measurements](xref:microsoft.quantum.libraries.standard.prelude#measurements) for more information.
 
 Similarly, the subcircuit