From cc425b0e5182c2746853f038eec282f14fc090f4 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 13:40:50 +0200 Subject: [PATCH 01/19] Placeholder files and TOC --- .../language-ref/attributes/entrypoint-ref.md | 0 .../language-ref/attributes/test-ref.md | 0 .../binding-assignment/let-ref.md | 13 ++ .../binding-assignment/mutable-ref.md | 13 ++ .../binding-assignment/new-ref.md | 13 ++ .../binding-assignment/set-ref.md | 13 ++ .../callables/functors/adjoint-ref.md | 13 ++ .../functors/controlled-adjoint-ref.md | 13 ++ .../callables/functors/controlled-ref.md | 13 ++ .../op-specializations/directives/auto-ref.md | 13 ++ .../directives/distribute-ref.md | 13 ++ .../directives/intrinsic-ref.md | 13 ++ .../directives/invert-ref.md | 13 ++ .../op-specializations/directives/self-ref.md | 13 ++ .../tags/adjoint-tag-ref.md | 13 ++ .../op-specializations/tags/body-tag-ref.md | 13 ++ .../tags/controlled-adjoint-tag-ref.md | 13 ++ .../tags/controlled-tag-ref.md | 13 ++ .../callables/partial-app-symb-ref.md | 13 ++ .../language-ref/callables/return-ref.md | 13 ++ .../callables/signature/adj-ctl-ref.md | 13 ++ .../callables/signature/adj-ref.md | 13 ++ .../callables/signature/ctl-ref.md | 13 ++ .../signature/fn-signature-symb-ref.md | 13 ++ .../callables/signature/is-ref.md | 13 ++ .../signature/op-signature-symb-ref.md | 13 ++ .../control-flow/apply-within-ref.md | 13 ++ .../language-ref/control-flow/elif-ref.md | 13 ++ .../language-ref/control-flow/else-ref.md | 13 ++ .../language-ref/control-flow/fail-ref.md | 13 ++ .../language-ref/control-flow/fixup-ref.md | 13 ++ .../language-ref/control-flow/for-ref.md | 13 ++ .../language-ref/control-flow/if-ref.md | 13 ++ .../language-ref/control-flow/in-ref.md | 13 ++ .../control-flow/repeat-until-ref.md | 13 ++ .../language-ref/control-flow/while-ref.md | 13 ++ .../language-ref/declaration/function-ref.md | 13 ++ .../language-ref/declaration/newtype-ref.md | 13 ++ .../language-ref/declaration/operation-ref.md | 13 ++ .../language-ref/namespace/as-ref.md | 13 ++ .../language-ref/namespace/namespace-ref.md | 13 ++ .../language-ref/namespace/open-ref.md | 13 ++ .../language-ref/qubits/borrowing-ref.md | 13 ++ .../language-ref/qubits/using-ref.md | 13 ++ articles/user-guide/language-ref/toc.yml | 156 ++++++++++++++++++ .../language-ref/types/bigint-ref.md | 13 ++ .../user-guide/language-ref/types/bool-ref.md | 13 ++ .../language-ref/types/double-ref.md | 13 ++ .../language-ref/types/false-ref.md | 13 ++ .../user-guide/language-ref/types/int-ref.md | 13 ++ .../user-guide/language-ref/types/one-ref.md | 13 ++ .../language-ref/types/pauli-ref.md | 13 ++ .../language-ref/types/paulii-ref.md | 13 ++ .../language-ref/types/paulix-ref.md | 13 ++ .../language-ref/types/pauliy-ref.md | 13 ++ .../language-ref/types/pauliz-ref.md | 13 ++ .../language-ref/types/qubit-ref.md | 13 ++ .../language-ref/types/range-ref.md | 13 ++ .../language-ref/types/result-ref.md | 13 ++ .../language-ref/types/string-ref.md | 13 ++ .../user-guide/language-ref/types/true-ref.md | 13 ++ .../user-guide/language-ref/types/unit-ref.md | 13 ++ .../user-guide/language-ref/types/zero-ref.md | 13 ++ articles/user-guide/language/types.md | 2 +- articles/user-guide/toc.yml | 4 +- 65 files changed, 940 insertions(+), 2 deletions(-) create mode 100644 articles/user-guide/language-ref/attributes/entrypoint-ref.md create mode 100644 articles/user-guide/language-ref/attributes/test-ref.md create mode 100644 articles/user-guide/language-ref/binding-assignment/let-ref.md create mode 100644 articles/user-guide/language-ref/binding-assignment/mutable-ref.md create mode 100644 articles/user-guide/language-ref/binding-assignment/new-ref.md create mode 100644 articles/user-guide/language-ref/binding-assignment/set-ref.md create mode 100644 articles/user-guide/language-ref/callables/functors/adjoint-ref.md create mode 100644 articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md create mode 100644 articles/user-guide/language-ref/callables/functors/controlled-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md create mode 100644 articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md create mode 100644 articles/user-guide/language-ref/callables/partial-app-symb-ref.md create mode 100644 articles/user-guide/language-ref/callables/return-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/adj-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/ctl-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/is-ref.md create mode 100644 articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/apply-within-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/elif-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/else-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/fail-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/fixup-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/for-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/if-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/in-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/repeat-until-ref.md create mode 100644 articles/user-guide/language-ref/control-flow/while-ref.md create mode 100644 articles/user-guide/language-ref/declaration/function-ref.md create mode 100644 articles/user-guide/language-ref/declaration/newtype-ref.md create mode 100644 articles/user-guide/language-ref/declaration/operation-ref.md create mode 100644 articles/user-guide/language-ref/namespace/as-ref.md create mode 100644 articles/user-guide/language-ref/namespace/namespace-ref.md create mode 100644 articles/user-guide/language-ref/namespace/open-ref.md create mode 100644 articles/user-guide/language-ref/qubits/borrowing-ref.md create mode 100644 articles/user-guide/language-ref/qubits/using-ref.md create mode 100644 articles/user-guide/language-ref/toc.yml create mode 100644 articles/user-guide/language-ref/types/bigint-ref.md create mode 100644 articles/user-guide/language-ref/types/bool-ref.md create mode 100644 articles/user-guide/language-ref/types/double-ref.md create mode 100644 articles/user-guide/language-ref/types/false-ref.md create mode 100644 articles/user-guide/language-ref/types/int-ref.md create mode 100644 articles/user-guide/language-ref/types/one-ref.md create mode 100644 articles/user-guide/language-ref/types/pauli-ref.md create mode 100644 articles/user-guide/language-ref/types/paulii-ref.md create mode 100644 articles/user-guide/language-ref/types/paulix-ref.md create mode 100644 articles/user-guide/language-ref/types/pauliy-ref.md create mode 100644 articles/user-guide/language-ref/types/pauliz-ref.md create mode 100644 articles/user-guide/language-ref/types/qubit-ref.md create mode 100644 articles/user-guide/language-ref/types/range-ref.md create mode 100644 articles/user-guide/language-ref/types/result-ref.md create mode 100644 articles/user-guide/language-ref/types/string-ref.md create mode 100644 articles/user-guide/language-ref/types/true-ref.md create mode 100644 articles/user-guide/language-ref/types/unit-ref.md create mode 100644 articles/user-guide/language-ref/types/zero-ref.md diff --git a/articles/user-guide/language-ref/attributes/entrypoint-ref.md b/articles/user-guide/language-ref/attributes/entrypoint-ref.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/articles/user-guide/language-ref/attributes/test-ref.md b/articles/user-guide/language-ref/attributes/test-ref.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/articles/user-guide/language-ref/binding-assignment/let-ref.md b/articles/user-guide/language-ref/binding-assignment/let-ref.md new file mode 100644 index 0000000000..b5c70d8883 --- /dev/null +++ b/articles/user-guide/language-ref/binding-assignment/let-ref.md @@ -0,0 +1,13 @@ +--- +title: let +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.let +--- + +# `let` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/mutable-ref.md b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md new file mode 100644 index 0000000000..2356308529 --- /dev/null +++ b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md @@ -0,0 +1,13 @@ +--- +title: mutable +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.mutable +--- + +# `mutable` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/new-ref.md b/articles/user-guide/language-ref/binding-assignment/new-ref.md new file mode 100644 index 0000000000..ec4a768ee9 --- /dev/null +++ b/articles/user-guide/language-ref/binding-assignment/new-ref.md @@ -0,0 +1,13 @@ +--- +title: new +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.new +--- + +# `new` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/set-ref.md b/articles/user-guide/language-ref/binding-assignment/set-ref.md new file mode 100644 index 0000000000..2eaa7d3dec --- /dev/null +++ b/articles/user-guide/language-ref/binding-assignment/set-ref.md @@ -0,0 +1,13 @@ +--- +title: set +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.set +--- + +# `set` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md new file mode 100644 index 0000000000..6d1e89aefc --- /dev/null +++ b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md @@ -0,0 +1,13 @@ +--- +title: Adjoint +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.adjoint +--- + +# `Adjoint` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md new file mode 100644 index 0000000000..085d751345 --- /dev/null +++ b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md @@ -0,0 +1,13 @@ +--- +title: Controlled Adjoint +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.controlled-adjoint +--- + +# `Controlled Adjoint` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/controlled-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-ref.md new file mode 100644 index 0000000000..6a77e568b3 --- /dev/null +++ b/articles/user-guide/language-ref/callables/functors/controlled-ref.md @@ -0,0 +1,13 @@ +--- +title: Controlled +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.controlled +--- + +# `Controlled` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md new file mode 100644 index 0000000000..10624f63e0 --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md @@ -0,0 +1,13 @@ +--- +title: auto +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.auto +--- + +# `auto` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md new file mode 100644 index 0000000000..2114d37a72 --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md @@ -0,0 +1,13 @@ +--- +title: distribute +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.distribute +--- + +# `distribute` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md new file mode 100644 index 0000000000..38bddce827 --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md @@ -0,0 +1,13 @@ +--- +title: intrinsic +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.intrinsic +--- + +# `intrinsic` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md new file mode 100644 index 0000000000..500f0fdc0e --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md @@ -0,0 +1,13 @@ +--- +title: invert +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.invert +--- + +# `invert` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md new file mode 100644 index 0000000000..0f66f5b61b --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md @@ -0,0 +1,13 @@ +--- +title: self +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.self +--- + +# `self` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md new file mode 100644 index 0000000000..c600430d8d --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md @@ -0,0 +1,13 @@ +--- +title: adjoint (Specialization Tag) +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.adjoint-tag +--- + +# `adjoint` (Specialization Tag) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md new file mode 100644 index 0000000000..d0a6f85bb6 --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md @@ -0,0 +1,13 @@ +--- +title: body (Specialization Tag) +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.body-tag +--- + +# `body` (Specialization Tag) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md new file mode 100644 index 0000000000..e113cf15d8 --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md @@ -0,0 +1,13 @@ +--- +title: controlled adjoint (Specialization Tag) +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.controlled-adjoint-tag +--- + +# `controlled adjoint` (Specialization Tag) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md new file mode 100644 index 0000000000..f3abdb9f4e --- /dev/null +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md @@ -0,0 +1,13 @@ +--- +title: controlled (Specialization Tag) +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.controlled-tag +--- + +# `controlled` (Specialization Tag) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md new file mode 100644 index 0000000000..fd579db924 --- /dev/null +++ b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md @@ -0,0 +1,13 @@ +--- +title: '_ (Partial Application)' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.partial-app-symb +--- + +# `_` (Partial Application) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/return-ref.md b/articles/user-guide/language-ref/callables/return-ref.md new file mode 100644 index 0000000000..b3c8cad660 --- /dev/null +++ b/articles/user-guide/language-ref/callables/return-ref.md @@ -0,0 +1,13 @@ +--- +title: return +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.return +--- + +# `return` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md new file mode 100644 index 0000000000..a614160585 --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md @@ -0,0 +1,13 @@ +--- +title: 'Adj + Ctl' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.adj-ctl +--- + +# `Adj + Ctl` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/adj-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ref.md new file mode 100644 index 0000000000..b54c1f16d5 --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/adj-ref.md @@ -0,0 +1,13 @@ +--- +title: Adj +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.adj +--- + +# `Adj` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/ctl-ref.md b/articles/user-guide/language-ref/callables/signature/ctl-ref.md new file mode 100644 index 0000000000..45f6a780c7 --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/ctl-ref.md @@ -0,0 +1,13 @@ +--- +title: Ctl +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.ctl +--- + +# `Ctl` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md new file mode 100644 index 0000000000..f66f1a458e --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md @@ -0,0 +1,13 @@ +--- +title: '-> (Function Signature)' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.fn-signature-symb +--- + +# `->` (Function Signature) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/is-ref.md b/articles/user-guide/language-ref/callables/signature/is-ref.md new file mode 100644 index 0000000000..69e4b4523a --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/is-ref.md @@ -0,0 +1,13 @@ +--- +title: is +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.is +--- + +# `is` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md new file mode 100644 index 0000000000..0914932748 --- /dev/null +++ b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md @@ -0,0 +1,13 @@ +--- +title: '=> (Operation Signature)' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.op-signature-symb +--- + +# `=>` (Operation Signature) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/apply-within-ref.md b/articles/user-guide/language-ref/control-flow/apply-within-ref.md new file mode 100644 index 0000000000..a0a53389e9 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/apply-within-ref.md @@ -0,0 +1,13 @@ +--- +title: apply-within (Conjugation) +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.apply-within +--- + +# `apply-within` (Conjugation) + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/elif-ref.md b/articles/user-guide/language-ref/control-flow/elif-ref.md new file mode 100644 index 0000000000..35c68884a3 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/elif-ref.md @@ -0,0 +1,13 @@ +--- +title: elif +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.elif +--- + +# `elif` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/else-ref.md b/articles/user-guide/language-ref/control-flow/else-ref.md new file mode 100644 index 0000000000..d273b56a15 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/else-ref.md @@ -0,0 +1,13 @@ +--- +title: else +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.else +--- + +# `else` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/fail-ref.md b/articles/user-guide/language-ref/control-flow/fail-ref.md new file mode 100644 index 0000000000..059ade6fdc --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/fail-ref.md @@ -0,0 +1,13 @@ +--- +title: fail +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.fail +--- + +# `fail` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/fixup-ref.md b/articles/user-guide/language-ref/control-flow/fixup-ref.md new file mode 100644 index 0000000000..aeb9128f3a --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/fixup-ref.md @@ -0,0 +1,13 @@ +--- +title: fixup +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.fixup +--- + +# `fixup` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/for-ref.md b/articles/user-guide/language-ref/control-flow/for-ref.md new file mode 100644 index 0000000000..f721746221 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/for-ref.md @@ -0,0 +1,13 @@ +--- +title: for +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.for +--- + +# `for` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/if-ref.md b/articles/user-guide/language-ref/control-flow/if-ref.md new file mode 100644 index 0000000000..5110b3f1fe --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/if-ref.md @@ -0,0 +1,13 @@ +--- +title: if +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.if +--- + +# `if` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/in-ref.md b/articles/user-guide/language-ref/control-flow/in-ref.md new file mode 100644 index 0000000000..d33dc24b55 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/in-ref.md @@ -0,0 +1,13 @@ +--- +title: in +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.in +--- + +# `in` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/repeat-until-ref.md b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md new file mode 100644 index 0000000000..71272afcb2 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md @@ -0,0 +1,13 @@ +--- +title: repeat-until +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.repeat-until +--- + +# `repeat-until` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/while-ref.md b/articles/user-guide/language-ref/control-flow/while-ref.md new file mode 100644 index 0000000000..235bb40c19 --- /dev/null +++ b/articles/user-guide/language-ref/control-flow/while-ref.md @@ -0,0 +1,13 @@ +--- +title: while +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.while +--- + +# `while` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/function-ref.md b/articles/user-guide/language-ref/declaration/function-ref.md new file mode 100644 index 0000000000..29a0a0bb7c --- /dev/null +++ b/articles/user-guide/language-ref/declaration/function-ref.md @@ -0,0 +1,13 @@ +--- +title: function +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.function +--- + +# `function` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/newtype-ref.md b/articles/user-guide/language-ref/declaration/newtype-ref.md new file mode 100644 index 0000000000..8addda8f7f --- /dev/null +++ b/articles/user-guide/language-ref/declaration/newtype-ref.md @@ -0,0 +1,13 @@ +--- +title: newtype +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.newtype +--- + +# `newtype` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/operation-ref.md b/articles/user-guide/language-ref/declaration/operation-ref.md new file mode 100644 index 0000000000..614dd173a8 --- /dev/null +++ b/articles/user-guide/language-ref/declaration/operation-ref.md @@ -0,0 +1,13 @@ +--- +title: operation +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.operation +--- + +# `operation` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/namespace/as-ref.md b/articles/user-guide/language-ref/namespace/as-ref.md new file mode 100644 index 0000000000..86c277aae6 --- /dev/null +++ b/articles/user-guide/language-ref/namespace/as-ref.md @@ -0,0 +1,13 @@ +--- +title: as +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.as +--- + +# `as` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/namespace/namespace-ref.md b/articles/user-guide/language-ref/namespace/namespace-ref.md new file mode 100644 index 0000000000..c68163bf12 --- /dev/null +++ b/articles/user-guide/language-ref/namespace/namespace-ref.md @@ -0,0 +1,13 @@ +--- +title: namespace +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.namespace +--- + +# `namespace` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/namespace/open-ref.md b/articles/user-guide/language-ref/namespace/open-ref.md new file mode 100644 index 0000000000..245699f735 --- /dev/null +++ b/articles/user-guide/language-ref/namespace/open-ref.md @@ -0,0 +1,13 @@ +--- +title: open +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.open +--- + +# `open` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/qubits/borrowing-ref.md b/articles/user-guide/language-ref/qubits/borrowing-ref.md new file mode 100644 index 0000000000..0ca37891f3 --- /dev/null +++ b/articles/user-guide/language-ref/qubits/borrowing-ref.md @@ -0,0 +1,13 @@ +--- +title: borrowing +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.borrowing +--- + +# `borrowing` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/qubits/using-ref.md b/articles/user-guide/language-ref/qubits/using-ref.md new file mode 100644 index 0000000000..f2a8657897 --- /dev/null +++ b/articles/user-guide/language-ref/qubits/using-ref.md @@ -0,0 +1,13 @@ +--- +title: using +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.using +--- + +# `using` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml new file mode 100644 index 0000000000..cde82b4307 --- /dev/null +++ b/articles/user-guide/language-ref/toc.yml @@ -0,0 +1,156 @@ + expanded: true + items: + - name: Types + items: + - name: Primitive types + items: + - name: Int + href: types/int-ref.md + - name: BigInt + href: types/bigint-ref.md + - name: Double + href: types/double-ref.md + - name: Bool + href: types/bool-ref.md + - name: Range + href: types/range-ref.md + - name: String + href: types/string-ref.md + - name: Unit + href: types/unit-ref.md + - name: Qubit + href: types/qubit-ref.md + - name: Pauli + href: types/pauli-ref.md + - name: Result + href: types/result-ref.md + - name: Reserved symbols + items: + - name: true + href: types/true-ref.md + - name: false + href: types/false-ref.md + - name: PauliI + href: types/paulii-ref.md + - name: PauliX + href: types/paulix-ref.md + - name: PauliY + href: types/pauliy-ref.md + - name: PauliZ + href: types/pauliz-ref.md + - name: Zero + href: types/zero-ref.md + - name: One + href: types/one-ref.md + - name: 'Binding/Assignment' + items: + - name: new + href: binding-assignment/new-ref.md + - name: let + href: binding-assignment/let-ref.md + - name: mutable + href: binding-assignment/mutable-ref.md + - name: set + href: binding-assignment/set-ref.md + - name: Declaration + items: + - name: operation + href: declaration/operation-ref.md + - name: function + href: declaration/function-ref.md + - name: newtype + href: declaration/newtype-ref.md + - name: Callables + items: + - name: Functors + items: + - name: Controlled + href: callables/functors/controlled-ref.md + - name: Adjoint + href: callables/functors/adjoint-ref.md + - name: Controlled Adjoint + href: callables/functors/controlled-adjoint-ref.md + - name: Signatures + items: + - name: is + href: callables/signature/is-ref.md + - name: Ctl + href: callables/signature/ctl-ref.md + - name: Adj + href: callables/signature/adj-ref.md + - name: 'Ctl + Adj' + href: callables/signature/adj-ctl-ref.md + - name: '=> (Operation)' + href: callables/signature/op-signature-symb-ref.md + - name: '-> (Function)' + href: callables/signature/fn-signature-symb-ref.md + - name: Operation Specializations + items: + - name: Tags + items: + - name: body + href: callables/op-specializations/tags/body-tag-ref.md + - name: adjoint + href: callables/op-specializations/tags/adjoint-tag-ref.md + - name: controlled + href: callables/op-specializations/tags/controlled-tag-ref.md + - name: controlled adjoint + href: callables/op-specializations/tags/controlled-adjoint-tag-ref.md + - name: Directives + items: + - name: intrinsic + href: callables/op-specializations/directives/intrinsic-ref.md + - name: distribute + href: callables/op-specializations/directives/distribute-ref.md + - name: invert + href: callables/op-specializations/directives/invert-ref.md + - name: self + href: callables/op-specializations/directives/self-ref.md + - name: auto + href: callables/op-specializations/directives/auto-ref.md + - name: return + href: callables/return-ref.md + - name: '_ (Partial Application)' + href: callables/partial-app-symb-ref.md + - name: Control Flow + items: + - name: for + href: control-flow/for-ref.md + - name: in + href: control-flow/in-ref.md + - name: if + href: control-flow/if-ref.md + - name: elif + href: control-flow/elif-ref.md + - name: else + href: control-flow/else-ref.md + - name: repeat-until + href: control-flow/repeat-until-ref.md + - name: fixup + href: control-flow/fixup-ref.md + - name: while + href: control-flow/while-ref.md + - name: apply-within (Conjugation) + href: control-flow/apply-within-ref.md + - name: fail + href: control-flow/fail-ref.md + - name: Qubits + items: + - name: using + href: qubits/using-ref.md + - name: borrowing + href: qubits/borrowing-ref.md + - name: Namespace + items: + - name: namespace + href: namespace/namespace-ref.md + - name: open + href: namespace/open-ref.md + - name: as + href: namespace/as-ref.md + - name: Attributes + items: + - name: '@EntryPoint' + href: attributes/entrypoint-ref.md + - name: '@Test("...")' + href: attributes/test-ref.md \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/bigint-ref.md b/articles/user-guide/language-ref/types/bigint-ref.md new file mode 100644 index 0000000000..677666159c --- /dev/null +++ b/articles/user-guide/language-ref/types/bigint-ref.md @@ -0,0 +1,13 @@ +--- +title: BigInt +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.bigint +--- + +# `BigInt` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/bool-ref.md b/articles/user-guide/language-ref/types/bool-ref.md new file mode 100644 index 0000000000..802186bf19 --- /dev/null +++ b/articles/user-guide/language-ref/types/bool-ref.md @@ -0,0 +1,13 @@ +--- +title: Bool +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.bool +--- + +# `Bool` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/double-ref.md b/articles/user-guide/language-ref/types/double-ref.md new file mode 100644 index 0000000000..2d2dd3b5a5 --- /dev/null +++ b/articles/user-guide/language-ref/types/double-ref.md @@ -0,0 +1,13 @@ +--- +title: Double +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.double +--- + +# `Double` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/false-ref.md b/articles/user-guide/language-ref/types/false-ref.md new file mode 100644 index 0000000000..2e12977ac9 --- /dev/null +++ b/articles/user-guide/language-ref/types/false-ref.md @@ -0,0 +1,13 @@ +--- +title: false +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.false +--- + +# `false` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/int-ref.md b/articles/user-guide/language-ref/types/int-ref.md new file mode 100644 index 0000000000..b107b92546 --- /dev/null +++ b/articles/user-guide/language-ref/types/int-ref.md @@ -0,0 +1,13 @@ +--- +title: Int +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.int +--- + +# `Int` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/one-ref.md b/articles/user-guide/language-ref/types/one-ref.md new file mode 100644 index 0000000000..72db77e584 --- /dev/null +++ b/articles/user-guide/language-ref/types/one-ref.md @@ -0,0 +1,13 @@ +--- +title: One +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.one +--- + +# `One` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/pauli-ref.md b/articles/user-guide/language-ref/types/pauli-ref.md new file mode 100644 index 0000000000..a2591cee29 --- /dev/null +++ b/articles/user-guide/language-ref/types/pauli-ref.md @@ -0,0 +1,13 @@ +--- +title: Pauli +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.pauli +--- + +# `Pauli` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/paulii-ref.md b/articles/user-guide/language-ref/types/paulii-ref.md new file mode 100644 index 0000000000..7c8c60237a --- /dev/null +++ b/articles/user-guide/language-ref/types/paulii-ref.md @@ -0,0 +1,13 @@ +--- +title: PauliI +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.paulii +--- + +# `PauliI` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/paulix-ref.md b/articles/user-guide/language-ref/types/paulix-ref.md new file mode 100644 index 0000000000..af2f276357 --- /dev/null +++ b/articles/user-guide/language-ref/types/paulix-ref.md @@ -0,0 +1,13 @@ +--- +title: PauliX +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.paulix +--- + +# `PauliX` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/pauliy-ref.md b/articles/user-guide/language-ref/types/pauliy-ref.md new file mode 100644 index 0000000000..3aac557219 --- /dev/null +++ b/articles/user-guide/language-ref/types/pauliy-ref.md @@ -0,0 +1,13 @@ +--- +title: PauliY +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.pauliy +--- + +# `PauliY` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/pauliz-ref.md b/articles/user-guide/language-ref/types/pauliz-ref.md new file mode 100644 index 0000000000..044cbed9bd --- /dev/null +++ b/articles/user-guide/language-ref/types/pauliz-ref.md @@ -0,0 +1,13 @@ +--- +title: PauliZ +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.pauliz +--- + +# `PauliZ` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/qubit-ref.md b/articles/user-guide/language-ref/types/qubit-ref.md new file mode 100644 index 0000000000..7bf482140e --- /dev/null +++ b/articles/user-guide/language-ref/types/qubit-ref.md @@ -0,0 +1,13 @@ +--- +title: Qubit +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.qubit +--- + +# `Qubit` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/range-ref.md b/articles/user-guide/language-ref/types/range-ref.md new file mode 100644 index 0000000000..20f719ec8d --- /dev/null +++ b/articles/user-guide/language-ref/types/range-ref.md @@ -0,0 +1,13 @@ +--- +title: Range +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.range +--- + +# `Range` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/result-ref.md b/articles/user-guide/language-ref/types/result-ref.md new file mode 100644 index 0000000000..22c099a770 --- /dev/null +++ b/articles/user-guide/language-ref/types/result-ref.md @@ -0,0 +1,13 @@ +--- +title: Result +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.result +--- + +# `Result` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/string-ref.md b/articles/user-guide/language-ref/types/string-ref.md new file mode 100644 index 0000000000..b32f3763c2 --- /dev/null +++ b/articles/user-guide/language-ref/types/string-ref.md @@ -0,0 +1,13 @@ +--- +title: String +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.string +--- + +# `String` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/true-ref.md b/articles/user-guide/language-ref/types/true-ref.md new file mode 100644 index 0000000000..3b96ca3e8b --- /dev/null +++ b/articles/user-guide/language-ref/types/true-ref.md @@ -0,0 +1,13 @@ +--- +title: true +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.true +--- + +# `true` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/unit-ref.md b/articles/user-guide/language-ref/types/unit-ref.md new file mode 100644 index 0000000000..cb39892703 --- /dev/null +++ b/articles/user-guide/language-ref/types/unit-ref.md @@ -0,0 +1,13 @@ +--- +title: Unit +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.unit +--- + +# `Unit` + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/zero-ref.md b/articles/user-guide/language-ref/types/zero-ref.md new file mode 100644 index 0000000000..e95ef07343 --- /dev/null +++ b/articles/user-guide/language-ref/types/zero-ref.md @@ -0,0 +1,13 @@ +--- +title: Zero +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.zero +--- + +# `Zero` + +fill \ No newline at end of file diff --git a/articles/user-guide/language/types.md b/articles/user-guide/language/types.md index 6d7296cb66..619c990e12 100644 --- a/articles/user-guide/language/types.md +++ b/articles/user-guide/language/types.md @@ -2,7 +2,7 @@ title: Types in Q# description: Learn about the different types used in the Q# programming language. author: gillenhaalb -ms.author: a-gibec@microsoft.com +ms.author: a-gibec ms.date: 03/05/2020 ms.topic: article uid: microsoft.quantum.guide.types diff --git a/articles/user-guide/toc.yml b/articles/user-guide/toc.yml index b0cc1c0938..78c64db73c 100644 --- a/articles/user-guide/toc.yml +++ b/articles/user-guide/toc.yml @@ -13,4 +13,6 @@ - name: Q# libraries href: libraries/toc.yml - name: Quick reference - href: quickref/toc.yml \ No newline at end of file + href: quickref/toc.yml +- name: Language reference + href: language-ref/toc.yml \ No newline at end of file From fb7e7986445b91c13ca01a146594868623e9816a Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 14:14:52 +0200 Subject: [PATCH 02/19] Added attribute placeholder pages --- .../language-ref/attributes/entrypoint-ref.md | 13 +++++++++++++ .../user-guide/language-ref/attributes/test-ref.md | 13 +++++++++++++ .../language-ref/callables/partial-app-symb-ref.md | 2 +- .../callables/signature/fn-signature-symb-ref.md | 2 +- .../callables/signature/op-signature-symb-ref.md | 2 +- articles/user-guide/language-ref/toc.yml | 2 +- 6 files changed, 30 insertions(+), 4 deletions(-) diff --git a/articles/user-guide/language-ref/attributes/entrypoint-ref.md b/articles/user-guide/language-ref/attributes/entrypoint-ref.md index e69de29bb2..cadc13c21a 100644 --- a/articles/user-guide/language-ref/attributes/entrypoint-ref.md +++ b/articles/user-guide/language-ref/attributes/entrypoint-ref.md @@ -0,0 +1,13 @@ +--- +title: '@EntryPoint' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.entrypoint +--- + +# '`@EntryPoint`' + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/attributes/test-ref.md b/articles/user-guide/language-ref/attributes/test-ref.md index e69de29bb2..b60dd6a1f8 100644 --- a/articles/user-guide/language-ref/attributes/test-ref.md +++ b/articles/user-guide/language-ref/attributes/test-ref.md @@ -0,0 +1,13 @@ +--- +title: '@Test' +description: Keyword reference +author: gillenhaalb +ms.author: a-gibec +ms.date: 05/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.test +--- + +# '`@Test`' + +fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md index fd579db924..793545d2e9 100644 --- a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md +++ b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.partial-app-symb --- -# `_` (Partial Application) +# '`_` (Partial Application)' fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md index f66f1a458e..260eb697d8 100644 --- a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.fn-signature-symb --- -# `->` (Function Signature) +# '`->` (Function Signature)' fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md index 0914932748..c9a2b865de 100644 --- a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.op-signature-symb --- -# `=>` (Operation Signature) +# '`=>` (Operation Signature)' fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index cde82b4307..54daf44524 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -152,5 +152,5 @@ items: - name: '@EntryPoint' href: attributes/entrypoint-ref.md - - name: '@Test("...")' + - name: '@Test' href: attributes/test-ref.md \ No newline at end of file From 89f9187f3cbc6034eea2cf2e96a76a75af32f852 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 14:53:20 +0200 Subject: [PATCH 03/19] fix metadata warnings --- articles/user-guide/language-ref/attributes/entrypoint-ref.md | 2 +- articles/user-guide/language-ref/attributes/test-ref.md | 2 +- .../user-guide/language-ref/binding-assignment/let-ref.md | 2 +- .../user-guide/language-ref/binding-assignment/mutable-ref.md | 2 +- .../user-guide/language-ref/binding-assignment/new-ref.md | 2 +- .../user-guide/language-ref/binding-assignment/set-ref.md | 2 +- .../user-guide/language-ref/callables/functors/adjoint-ref.md | 2 +- .../language-ref/callables/functors/controlled-adjoint-ref.md | 2 +- .../language-ref/callables/functors/controlled-ref.md | 2 +- .../callables/op-specializations/directives/auto-ref.md | 2 +- .../callables/op-specializations/directives/distribute-ref.md | 2 +- .../callables/op-specializations/directives/intrinsic-ref.md | 2 +- .../callables/op-specializations/directives/invert-ref.md | 2 +- .../callables/op-specializations/directives/self-ref.md | 2 +- .../callables/op-specializations/tags/adjoint-tag-ref.md | 2 +- .../callables/op-specializations/tags/body-tag-ref.md | 2 +- .../op-specializations/tags/controlled-adjoint-tag-ref.md | 2 +- .../callables/op-specializations/tags/controlled-tag-ref.md | 2 +- .../user-guide/language-ref/callables/partial-app-symb-ref.md | 2 +- articles/user-guide/language-ref/callables/return-ref.md | 2 +- .../language-ref/callables/signature/adj-ctl-ref.md | 2 +- .../user-guide/language-ref/callables/signature/adj-ref.md | 2 +- .../user-guide/language-ref/callables/signature/ctl-ref.md | 2 +- .../language-ref/callables/signature/fn-signature-symb-ref.md | 2 +- .../user-guide/language-ref/callables/signature/is-ref.md | 2 +- .../language-ref/callables/signature/op-signature-symb-ref.md | 2 +- .../user-guide/language-ref/control-flow/apply-within-ref.md | 2 +- articles/user-guide/language-ref/control-flow/elif-ref.md | 2 +- articles/user-guide/language-ref/control-flow/else-ref.md | 2 +- articles/user-guide/language-ref/control-flow/fail-ref.md | 2 +- articles/user-guide/language-ref/control-flow/fixup-ref.md | 2 +- articles/user-guide/language-ref/control-flow/for-ref.md | 2 +- articles/user-guide/language-ref/control-flow/if-ref.md | 2 +- articles/user-guide/language-ref/control-flow/in-ref.md | 2 +- .../user-guide/language-ref/control-flow/repeat-until-ref.md | 2 +- articles/user-guide/language-ref/control-flow/while-ref.md | 2 +- articles/user-guide/language-ref/declaration/function-ref.md | 2 +- articles/user-guide/language-ref/declaration/newtype-ref.md | 2 +- articles/user-guide/language-ref/declaration/operation-ref.md | 2 +- articles/user-guide/language-ref/namespace/as-ref.md | 2 +- articles/user-guide/language-ref/namespace/namespace-ref.md | 2 +- articles/user-guide/language-ref/namespace/open-ref.md | 2 +- articles/user-guide/language-ref/qubits/borrowing-ref.md | 2 +- articles/user-guide/language-ref/qubits/using-ref.md | 2 +- articles/user-guide/language-ref/types/bigint-ref.md | 2 +- articles/user-guide/language-ref/types/bool-ref.md | 2 +- articles/user-guide/language-ref/types/double-ref.md | 2 +- articles/user-guide/language-ref/types/false-ref.md | 4 ++-- articles/user-guide/language-ref/types/int-ref.md | 2 +- articles/user-guide/language-ref/types/one-ref.md | 2 +- articles/user-guide/language-ref/types/pauli-ref.md | 2 +- articles/user-guide/language-ref/types/paulii-ref.md | 2 +- articles/user-guide/language-ref/types/paulix-ref.md | 2 +- articles/user-guide/language-ref/types/pauliy-ref.md | 2 +- articles/user-guide/language-ref/types/pauliz-ref.md | 2 +- articles/user-guide/language-ref/types/qubit-ref.md | 2 +- articles/user-guide/language-ref/types/range-ref.md | 2 +- articles/user-guide/language-ref/types/result-ref.md | 2 +- articles/user-guide/language-ref/types/string-ref.md | 2 +- articles/user-guide/language-ref/types/true-ref.md | 4 ++-- articles/user-guide/language-ref/types/unit-ref.md | 2 +- articles/user-guide/language-ref/types/zero-ref.md | 2 +- 62 files changed, 64 insertions(+), 64 deletions(-) diff --git a/articles/user-guide/language-ref/attributes/entrypoint-ref.md b/articles/user-guide/language-ref/attributes/entrypoint-ref.md index cadc13c21a..9ca9697648 100644 --- a/articles/user-guide/language-ref/attributes/entrypoint-ref.md +++ b/articles/user-guide/language-ref/attributes/entrypoint-ref.md @@ -1,6 +1,6 @@ --- title: '@EntryPoint' -description: Keyword reference +description: Keyword reference '@EntryPoint' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/attributes/test-ref.md b/articles/user-guide/language-ref/attributes/test-ref.md index b60dd6a1f8..8a11cec7bc 100644 --- a/articles/user-guide/language-ref/attributes/test-ref.md +++ b/articles/user-guide/language-ref/attributes/test-ref.md @@ -1,6 +1,6 @@ --- title: '@Test' -description: Keyword reference +description: Keyword reference '@Test' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/binding-assignment/let-ref.md b/articles/user-guide/language-ref/binding-assignment/let-ref.md index b5c70d8883..b92bec9638 100644 --- a/articles/user-guide/language-ref/binding-assignment/let-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/let-ref.md @@ -1,6 +1,6 @@ --- title: let -description: Keyword reference +description: Keyword reference let author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/binding-assignment/mutable-ref.md b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md index 2356308529..0cf07fee4e 100644 --- a/articles/user-guide/language-ref/binding-assignment/mutable-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md @@ -1,6 +1,6 @@ --- title: mutable -description: Keyword reference +description: Keyword reference mutable author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/binding-assignment/new-ref.md b/articles/user-guide/language-ref/binding-assignment/new-ref.md index ec4a768ee9..de3e713aca 100644 --- a/articles/user-guide/language-ref/binding-assignment/new-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/new-ref.md @@ -1,6 +1,6 @@ --- title: new -description: Keyword reference +description: Keyword reference new author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/binding-assignment/set-ref.md b/articles/user-guide/language-ref/binding-assignment/set-ref.md index 2eaa7d3dec..840fa2ad07 100644 --- a/articles/user-guide/language-ref/binding-assignment/set-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/set-ref.md @@ -1,6 +1,6 @@ --- title: set -description: Keyword reference +description: Keyword reference set author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/functors/adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md index 6d1e89aefc..e06653c46e 100644 --- a/articles/user-guide/language-ref/callables/functors/adjoint-ref.md +++ b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md @@ -1,6 +1,6 @@ --- title: Adjoint -description: Keyword reference +description: Keyword reference Adjoint author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md index 085d751345..a801178351 100644 --- a/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md +++ b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md @@ -1,6 +1,6 @@ --- title: Controlled Adjoint -description: Keyword reference +description: Keyword reference Controlled Adjoint author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/functors/controlled-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-ref.md index 6a77e568b3..45f11aa0ea 100644 --- a/articles/user-guide/language-ref/callables/functors/controlled-ref.md +++ b/articles/user-guide/language-ref/callables/functors/controlled-ref.md @@ -1,6 +1,6 @@ --- title: Controlled -description: Keyword reference +description: Keyword reference Controlled author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md index 10624f63e0..e0c31c49fa 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md @@ -1,6 +1,6 @@ --- title: auto -description: Keyword reference +description: Keyword reference auto author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md index 2114d37a72..3a78587082 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md @@ -1,6 +1,6 @@ --- title: distribute -description: Keyword reference +description: Keyword reference distribute author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md index 38bddce827..2b929d5d4f 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md @@ -1,6 +1,6 @@ --- title: intrinsic -description: Keyword reference +description: Keyword reference intrinsic author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md index 500f0fdc0e..1f2f6263f0 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md @@ -1,6 +1,6 @@ --- title: invert -description: Keyword reference +description: Keyword reference invert author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md index 0f66f5b61b..6d5562a6c6 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md @@ -1,6 +1,6 @@ --- title: self -description: Keyword reference +description: Keyword reference self author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md index c600430d8d..55cd986329 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md @@ -1,6 +1,6 @@ --- title: adjoint (Specialization Tag) -description: Keyword reference +description: Keyword reference (specialization tag) adjoint author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md index d0a6f85bb6..59de49a787 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md @@ -1,6 +1,6 @@ --- title: body (Specialization Tag) -description: Keyword reference +description: Keyword reference (specialization tag) body author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md index e113cf15d8..b5fa0ed163 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md @@ -1,6 +1,6 @@ --- title: controlled adjoint (Specialization Tag) -description: Keyword reference +description: Keyword reference (specialization tag) controlled adjoint author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md index f3abdb9f4e..dc3cb7963d 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md @@ -1,6 +1,6 @@ --- title: controlled (Specialization Tag) -description: Keyword reference +description: Keyword reference (specialization tag) controlled author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md index 793545d2e9..b9e6ad1537 100644 --- a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md +++ b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md @@ -1,6 +1,6 @@ --- title: '_ (Partial Application)' -description: Keyword reference +description: 'Keyword reference _ partial application symbol' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/return-ref.md b/articles/user-guide/language-ref/callables/return-ref.md index b3c8cad660..163621502d 100644 --- a/articles/user-guide/language-ref/callables/return-ref.md +++ b/articles/user-guide/language-ref/callables/return-ref.md @@ -1,6 +1,6 @@ --- title: return -description: Keyword reference +description: Keyword reference return author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md index a614160585..18a65cce00 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md @@ -1,6 +1,6 @@ --- title: 'Adj + Ctl' -description: Keyword reference +description: Keyword reference 'Adj + Ctl' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/adj-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ref.md index b54c1f16d5..8b6ea4b90b 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ref.md @@ -1,6 +1,6 @@ --- title: Adj -description: Keyword reference +description: Keyword reference Adj author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/ctl-ref.md b/articles/user-guide/language-ref/callables/signature/ctl-ref.md index 45f6a780c7..e98a5461a0 100644 --- a/articles/user-guide/language-ref/callables/signature/ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/ctl-ref.md @@ -1,6 +1,6 @@ --- title: Ctl -description: Keyword reference +description: Keyword reference Ctl author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md index 260eb697d8..4067b88a3f 100644 --- a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md @@ -1,6 +1,6 @@ --- title: '-> (Function Signature)' -description: Keyword reference +description: 'Keyword reference -> function signature symbol' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/is-ref.md b/articles/user-guide/language-ref/callables/signature/is-ref.md index 69e4b4523a..6eac9d4044 100644 --- a/articles/user-guide/language-ref/callables/signature/is-ref.md +++ b/articles/user-guide/language-ref/callables/signature/is-ref.md @@ -1,6 +1,6 @@ --- title: is -description: Keyword reference +description: Keyword reference is author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md index c9a2b865de..46d17a9215 100644 --- a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md @@ -1,6 +1,6 @@ --- title: '=> (Operation Signature)' -description: Keyword reference +description: 'Keyword reference => operation signature symbol' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/apply-within-ref.md b/articles/user-guide/language-ref/control-flow/apply-within-ref.md index a0a53389e9..705c3ee5bf 100644 --- a/articles/user-guide/language-ref/control-flow/apply-within-ref.md +++ b/articles/user-guide/language-ref/control-flow/apply-within-ref.md @@ -1,6 +1,6 @@ --- title: apply-within (Conjugation) -description: Keyword reference +description: Keyword reference apply-within author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/elif-ref.md b/articles/user-guide/language-ref/control-flow/elif-ref.md index 35c68884a3..c9016a975a 100644 --- a/articles/user-guide/language-ref/control-flow/elif-ref.md +++ b/articles/user-guide/language-ref/control-flow/elif-ref.md @@ -1,6 +1,6 @@ --- title: elif -description: Keyword reference +description: Keyword reference elif author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/else-ref.md b/articles/user-guide/language-ref/control-flow/else-ref.md index d273b56a15..9889bbac5d 100644 --- a/articles/user-guide/language-ref/control-flow/else-ref.md +++ b/articles/user-guide/language-ref/control-flow/else-ref.md @@ -1,6 +1,6 @@ --- title: else -description: Keyword reference +description: Keyword reference else author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/fail-ref.md b/articles/user-guide/language-ref/control-flow/fail-ref.md index 059ade6fdc..6ec4a15eb1 100644 --- a/articles/user-guide/language-ref/control-flow/fail-ref.md +++ b/articles/user-guide/language-ref/control-flow/fail-ref.md @@ -1,6 +1,6 @@ --- title: fail -description: Keyword reference +description: Keyword reference fail author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/fixup-ref.md b/articles/user-guide/language-ref/control-flow/fixup-ref.md index aeb9128f3a..9869c6c79b 100644 --- a/articles/user-guide/language-ref/control-flow/fixup-ref.md +++ b/articles/user-guide/language-ref/control-flow/fixup-ref.md @@ -1,6 +1,6 @@ --- title: fixup -description: Keyword reference +description: Keyword reference fixup author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/for-ref.md b/articles/user-guide/language-ref/control-flow/for-ref.md index f721746221..620121d35a 100644 --- a/articles/user-guide/language-ref/control-flow/for-ref.md +++ b/articles/user-guide/language-ref/control-flow/for-ref.md @@ -1,6 +1,6 @@ --- title: for -description: Keyword reference +description: Keyword reference for author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/if-ref.md b/articles/user-guide/language-ref/control-flow/if-ref.md index 5110b3f1fe..b002e15b47 100644 --- a/articles/user-guide/language-ref/control-flow/if-ref.md +++ b/articles/user-guide/language-ref/control-flow/if-ref.md @@ -1,6 +1,6 @@ --- title: if -description: Keyword reference +description: Keyword reference if author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/in-ref.md b/articles/user-guide/language-ref/control-flow/in-ref.md index d33dc24b55..b81c81ec57 100644 --- a/articles/user-guide/language-ref/control-flow/in-ref.md +++ b/articles/user-guide/language-ref/control-flow/in-ref.md @@ -1,6 +1,6 @@ --- title: in -description: Keyword reference +description: Keyword reference in author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/repeat-until-ref.md b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md index 71272afcb2..8f0a4f56f5 100644 --- a/articles/user-guide/language-ref/control-flow/repeat-until-ref.md +++ b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md @@ -1,6 +1,6 @@ --- title: repeat-until -description: Keyword reference +description: Keyword reference repeat-until author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/control-flow/while-ref.md b/articles/user-guide/language-ref/control-flow/while-ref.md index 235bb40c19..6ec6f0d4d8 100644 --- a/articles/user-guide/language-ref/control-flow/while-ref.md +++ b/articles/user-guide/language-ref/control-flow/while-ref.md @@ -1,6 +1,6 @@ --- title: while -description: Keyword reference +description: Keyword reference while author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/declaration/function-ref.md b/articles/user-guide/language-ref/declaration/function-ref.md index 29a0a0bb7c..df7b02277f 100644 --- a/articles/user-guide/language-ref/declaration/function-ref.md +++ b/articles/user-guide/language-ref/declaration/function-ref.md @@ -1,6 +1,6 @@ --- title: function -description: Keyword reference +description: Keyword reference function author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/declaration/newtype-ref.md b/articles/user-guide/language-ref/declaration/newtype-ref.md index 8addda8f7f..f2662cccc1 100644 --- a/articles/user-guide/language-ref/declaration/newtype-ref.md +++ b/articles/user-guide/language-ref/declaration/newtype-ref.md @@ -1,6 +1,6 @@ --- title: newtype -description: Keyword reference +description: Keyword reference newtype author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/declaration/operation-ref.md b/articles/user-guide/language-ref/declaration/operation-ref.md index 614dd173a8..ca1cf582dc 100644 --- a/articles/user-guide/language-ref/declaration/operation-ref.md +++ b/articles/user-guide/language-ref/declaration/operation-ref.md @@ -1,6 +1,6 @@ --- title: operation -description: Keyword reference +description: Keyword reference operation author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/namespace/as-ref.md b/articles/user-guide/language-ref/namespace/as-ref.md index 86c277aae6..05eefc53ca 100644 --- a/articles/user-guide/language-ref/namespace/as-ref.md +++ b/articles/user-guide/language-ref/namespace/as-ref.md @@ -1,6 +1,6 @@ --- title: as -description: Keyword reference +description: Keyword reference as author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/namespace/namespace-ref.md b/articles/user-guide/language-ref/namespace/namespace-ref.md index c68163bf12..6d63f44e60 100644 --- a/articles/user-guide/language-ref/namespace/namespace-ref.md +++ b/articles/user-guide/language-ref/namespace/namespace-ref.md @@ -1,6 +1,6 @@ --- title: namespace -description: Keyword reference +description: Keyword reference namespace author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/namespace/open-ref.md b/articles/user-guide/language-ref/namespace/open-ref.md index 245699f735..f53b644e64 100644 --- a/articles/user-guide/language-ref/namespace/open-ref.md +++ b/articles/user-guide/language-ref/namespace/open-ref.md @@ -1,6 +1,6 @@ --- title: open -description: Keyword reference +description: Keyword reference open author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/qubits/borrowing-ref.md b/articles/user-guide/language-ref/qubits/borrowing-ref.md index 0ca37891f3..8cf52fb9b4 100644 --- a/articles/user-guide/language-ref/qubits/borrowing-ref.md +++ b/articles/user-guide/language-ref/qubits/borrowing-ref.md @@ -1,6 +1,6 @@ --- title: borrowing -description: Keyword reference +description: Keyword reference borrowing author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/qubits/using-ref.md b/articles/user-guide/language-ref/qubits/using-ref.md index f2a8657897..9e95167087 100644 --- a/articles/user-guide/language-ref/qubits/using-ref.md +++ b/articles/user-guide/language-ref/qubits/using-ref.md @@ -1,6 +1,6 @@ --- title: using -description: Keyword reference +description: Keyword reference using author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/bigint-ref.md b/articles/user-guide/language-ref/types/bigint-ref.md index 677666159c..502d6f790c 100644 --- a/articles/user-guide/language-ref/types/bigint-ref.md +++ b/articles/user-guide/language-ref/types/bigint-ref.md @@ -1,6 +1,6 @@ --- title: BigInt -description: Keyword reference +description: Keyword reference BigInt author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/bool-ref.md b/articles/user-guide/language-ref/types/bool-ref.md index 802186bf19..f8310f4bcd 100644 --- a/articles/user-guide/language-ref/types/bool-ref.md +++ b/articles/user-guide/language-ref/types/bool-ref.md @@ -1,6 +1,6 @@ --- title: Bool -description: Keyword reference +description: Keyword reference Bool author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/double-ref.md b/articles/user-guide/language-ref/types/double-ref.md index 2d2dd3b5a5..bb71f1e773 100644 --- a/articles/user-guide/language-ref/types/double-ref.md +++ b/articles/user-guide/language-ref/types/double-ref.md @@ -1,6 +1,6 @@ --- title: Double -description: Keyword reference +description: Keyword reference Double author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/false-ref.md b/articles/user-guide/language-ref/types/false-ref.md index 2e12977ac9..d7bc82bca9 100644 --- a/articles/user-guide/language-ref/types/false-ref.md +++ b/articles/user-guide/language-ref/types/false-ref.md @@ -1,6 +1,6 @@ --- -title: false -description: Keyword reference +title: 'false' +description: Keyword reference 'false' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/int-ref.md b/articles/user-guide/language-ref/types/int-ref.md index b107b92546..ce5d4a84bb 100644 --- a/articles/user-guide/language-ref/types/int-ref.md +++ b/articles/user-guide/language-ref/types/int-ref.md @@ -1,6 +1,6 @@ --- title: Int -description: Keyword reference +description: Keyword reference Int author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/one-ref.md b/articles/user-guide/language-ref/types/one-ref.md index 72db77e584..696a08b2e2 100644 --- a/articles/user-guide/language-ref/types/one-ref.md +++ b/articles/user-guide/language-ref/types/one-ref.md @@ -1,6 +1,6 @@ --- title: One -description: Keyword reference +description: Keyword reference One author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/pauli-ref.md b/articles/user-guide/language-ref/types/pauli-ref.md index a2591cee29..f39fddffd5 100644 --- a/articles/user-guide/language-ref/types/pauli-ref.md +++ b/articles/user-guide/language-ref/types/pauli-ref.md @@ -1,6 +1,6 @@ --- title: Pauli -description: Keyword reference +description: Keyword reference Pauli author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/paulii-ref.md b/articles/user-guide/language-ref/types/paulii-ref.md index 7c8c60237a..1c545c8aaf 100644 --- a/articles/user-guide/language-ref/types/paulii-ref.md +++ b/articles/user-guide/language-ref/types/paulii-ref.md @@ -1,6 +1,6 @@ --- title: PauliI -description: Keyword reference +description: Keyword reference PauliI author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/paulix-ref.md b/articles/user-guide/language-ref/types/paulix-ref.md index af2f276357..a776e1049d 100644 --- a/articles/user-guide/language-ref/types/paulix-ref.md +++ b/articles/user-guide/language-ref/types/paulix-ref.md @@ -1,6 +1,6 @@ --- title: PauliX -description: Keyword reference +description: Keyword reference PauliX author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/pauliy-ref.md b/articles/user-guide/language-ref/types/pauliy-ref.md index 3aac557219..95be453453 100644 --- a/articles/user-guide/language-ref/types/pauliy-ref.md +++ b/articles/user-guide/language-ref/types/pauliy-ref.md @@ -1,6 +1,6 @@ --- title: PauliY -description: Keyword reference +description: Keyword reference PauliY author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/pauliz-ref.md b/articles/user-guide/language-ref/types/pauliz-ref.md index 044cbed9bd..3ae0dec88e 100644 --- a/articles/user-guide/language-ref/types/pauliz-ref.md +++ b/articles/user-guide/language-ref/types/pauliz-ref.md @@ -1,6 +1,6 @@ --- title: PauliZ -description: Keyword reference +description: Keyword reference PauliZ author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/qubit-ref.md b/articles/user-guide/language-ref/types/qubit-ref.md index 7bf482140e..da1fc34e9a 100644 --- a/articles/user-guide/language-ref/types/qubit-ref.md +++ b/articles/user-guide/language-ref/types/qubit-ref.md @@ -1,6 +1,6 @@ --- title: Qubit -description: Keyword reference +description: Keyword reference Qubit author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/range-ref.md b/articles/user-guide/language-ref/types/range-ref.md index 20f719ec8d..a15f9930a7 100644 --- a/articles/user-guide/language-ref/types/range-ref.md +++ b/articles/user-guide/language-ref/types/range-ref.md @@ -1,6 +1,6 @@ --- title: Range -description: Keyword reference +description: Keyword reference Range author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/result-ref.md b/articles/user-guide/language-ref/types/result-ref.md index 22c099a770..69274679d3 100644 --- a/articles/user-guide/language-ref/types/result-ref.md +++ b/articles/user-guide/language-ref/types/result-ref.md @@ -1,6 +1,6 @@ --- title: Result -description: Keyword reference +description: Keyword reference Result author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/string-ref.md b/articles/user-guide/language-ref/types/string-ref.md index b32f3763c2..4707bb6b63 100644 --- a/articles/user-guide/language-ref/types/string-ref.md +++ b/articles/user-guide/language-ref/types/string-ref.md @@ -1,6 +1,6 @@ --- title: String -description: Keyword reference +description: Keyword reference String author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/true-ref.md b/articles/user-guide/language-ref/types/true-ref.md index 3b96ca3e8b..ed2ce0185a 100644 --- a/articles/user-guide/language-ref/types/true-ref.md +++ b/articles/user-guide/language-ref/types/true-ref.md @@ -1,6 +1,6 @@ --- -title: true -description: Keyword reference +title: 'true' +description: Keyword reference 'true' author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/unit-ref.md b/articles/user-guide/language-ref/types/unit-ref.md index cb39892703..ba3877550b 100644 --- a/articles/user-guide/language-ref/types/unit-ref.md +++ b/articles/user-guide/language-ref/types/unit-ref.md @@ -1,6 +1,6 @@ --- title: Unit -description: Keyword reference +description: Keyword reference Unit author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 diff --git a/articles/user-guide/language-ref/types/zero-ref.md b/articles/user-guide/language-ref/types/zero-ref.md index e95ef07343..a5d827d024 100644 --- a/articles/user-guide/language-ref/types/zero-ref.md +++ b/articles/user-guide/language-ref/types/zero-ref.md @@ -1,6 +1,6 @@ --- title: Zero -description: Keyword reference +description: Keyword reference Zero author: gillenhaalb ms.author: a-gibec ms.date: 05/09/2020 From fcb1bf3fc3bd583463aa8ecd43effd2de80133dd Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 15:02:54 +0200 Subject: [PATCH 04/19] test avoid capitalize --- articles/user-guide/language-ref/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 54daf44524..739de3fac4 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -26,9 +26,9 @@ href: types/result-ref.md - name: Reserved symbols items: - - name: true + - name: 'true' href: types/true-ref.md - - name: false + - name: 'false' href: types/false-ref.md - name: PauliI href: types/paulii-ref.md From 980fada462232f7caf0cd9425647c8485d490958 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 15:13:09 +0200 Subject: [PATCH 05/19] fix H1s --- .../language-ref/attributes/entrypoint-ref.md | 2 +- .../user-guide/language-ref/attributes/test-ref.md | 2 +- .../language-ref/callables/partial-app-symb-ref.md | 4 ++-- .../callables/signature/fn-signature-symb-ref.md | 2 +- .../callables/signature/op-signature-symb-ref.md | 2 +- .../language-ref/control-flow/apply-within-ref.md | 4 ++-- articles/user-guide/language-ref/toc.yml | 14 +++++++------- 7 files changed, 15 insertions(+), 15 deletions(-) diff --git a/articles/user-guide/language-ref/attributes/entrypoint-ref.md b/articles/user-guide/language-ref/attributes/entrypoint-ref.md index 9ca9697648..71e9d9c3fc 100644 --- a/articles/user-guide/language-ref/attributes/entrypoint-ref.md +++ b/articles/user-guide/language-ref/attributes/entrypoint-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.entrypoint --- -# '`@EntryPoint`' +# `@EntryPoint` fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/attributes/test-ref.md b/articles/user-guide/language-ref/attributes/test-ref.md index 8a11cec7bc..63ae0629b5 100644 --- a/articles/user-guide/language-ref/attributes/test-ref.md +++ b/articles/user-guide/language-ref/attributes/test-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.test --- -# '`@Test`' +# `@Test` fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md index b9e6ad1537..c22198b0de 100644 --- a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md +++ b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md @@ -1,5 +1,5 @@ --- -title: '_ (Partial Application)' +title: '_ (partial application)' description: 'Keyword reference _ partial application symbol' author: gillenhaalb ms.author: a-gibec @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.partial-app-symb --- -# '`_` (Partial Application)' +# `_` (partial application) fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md index 4067b88a3f..9ff38c89e3 100644 --- a/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/fn-signature-symb-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.fn-signature-symb --- -# '`->` (Function Signature)' +# `->` (Function Signature) fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md index 46d17a9215..a4fb6720fe 100644 --- a/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md +++ b/articles/user-guide/language-ref/callables/signature/op-signature-symb-ref.md @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.op-signature-symb --- -# '`=>` (Operation Signature)' +# `=>` (Operation Signature) fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/apply-within-ref.md b/articles/user-guide/language-ref/control-flow/apply-within-ref.md index 705c3ee5bf..1631743200 100644 --- a/articles/user-guide/language-ref/control-flow/apply-within-ref.md +++ b/articles/user-guide/language-ref/control-flow/apply-within-ref.md @@ -1,5 +1,5 @@ --- -title: apply-within (Conjugation) +title: apply-within (conjugation) description: Keyword reference apply-within author: gillenhaalb ms.author: a-gibec @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.apply-within --- -# `apply-within` (Conjugation) +# `apply-within` (conjugation) fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 739de3fac4..c7e882c266 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -62,6 +62,10 @@ href: declaration/newtype-ref.md - name: Callables items: + - name: return + href: callables/return-ref.md + - name: '_ (partial application)' + href: callables/partial-app-symb-ref.md - name: Functors items: - name: Controlled @@ -78,11 +82,11 @@ href: callables/signature/ctl-ref.md - name: Adj href: callables/signature/adj-ref.md - - name: 'Ctl + Adj' + - name: 'Adj + Ctl' href: callables/signature/adj-ctl-ref.md - - name: '=> (Operation)' + - name: '=> (operation)' href: callables/signature/op-signature-symb-ref.md - - name: '-> (Function)' + - name: '-> (function)' href: callables/signature/fn-signature-symb-ref.md - name: Operation Specializations items: @@ -108,10 +112,6 @@ href: callables/op-specializations/directives/self-ref.md - name: auto href: callables/op-specializations/directives/auto-ref.md - - name: return - href: callables/return-ref.md - - name: '_ (Partial Application)' - href: callables/partial-app-symb-ref.md - name: Control Flow items: - name: for From f9ba27b40a878594362a39caffe14229b44fc711 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 5 Sep 2020 15:19:43 +0200 Subject: [PATCH 06/19] lowercase --- articles/user-guide/language-ref/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index c7e882c266..add22ca044 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -130,7 +130,7 @@ href: control-flow/fixup-ref.md - name: while href: control-flow/while-ref.md - - name: apply-within (Conjugation) + - name: apply-within (conjugation) href: control-flow/apply-within-ref.md - name: fail href: control-flow/fail-ref.md From e2d164ca0988ed6c5f4d2f4b7aa51daf777cf150 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 26 Sep 2020 23:01:54 +0200 Subject: [PATCH 07/19] blank keyword ref page --- .../language-ref/language-reference.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 articles/user-guide/language-ref/language-reference.md diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md new file mode 100644 index 0000000000..d1a434becc --- /dev/null +++ b/articles/user-guide/language-ref/language-reference.md @@ -0,0 +1,26 @@ +--- +title: Keyword reference +description: List of keywords and common symbols in the Q# language, with links to their respective pages in documentation +author: gillenhaalb +ms.author: a-gibec +ms.date: 20/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.main-list +--- + +# Keyword Reference + +This page contains links to information about all Q# language keywords and many common symbols. + +## Q# Keyword Table + +The following table shows all Q# keywords grouped alphabetically, together with brief descriptions and links to relevant topics that contain more information. + +|Keyword|Description|Links| +|-------|-----------|-----| +|`keyword`| description goes here |links to solo page (and page in user guide?)| + + +## See also + +- ?? \ No newline at end of file From c5bfe9302c3f808b53450bd98101287afc347af4 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sat, 26 Sep 2020 23:15:30 +0200 Subject: [PATCH 08/19] internal page --- .../language-ref/declaration/internal-ref.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 articles/user-guide/language-ref/declaration/internal-ref.md diff --git a/articles/user-guide/language-ref/declaration/internal-ref.md b/articles/user-guide/language-ref/declaration/internal-ref.md new file mode 100644 index 0000000000..8df936ee31 --- /dev/null +++ b/articles/user-guide/language-ref/declaration/internal-ref.md @@ -0,0 +1,36 @@ +--- +title: internal +description: Keyword reference internal +author: gillenhaalb +ms.author: a-gibec +ms.date: 20/09/2020 +ms.topic: article +uid: microsoft.quantum.lang-ref.internal +--- + +# `internal` + +In many cases, a callable or type name is intended strictly for use internal to a library or project, and is not a guaranteed part of the API offered by a library. +It is helpful to clearly indicate that this is the case when naming functions and operations so that accidental dependencies on internal-only code are made obvious. +If an operation or function is not intended for direct use, but rather should be used by a matching callable which acts by partial application, consider using a name starting with the `internal` keyword for the callable that is partially applied. + +As per the Style Guide, we suggest: + +- When a function, operation, or user-defined type is not a part of the public API for a Q# library or program, ensure that it is marked as internal by placing the `internal` keyword before the `function`, `operation`, or `newtype` declaration. + +## Examples + +```qsharp +internal operation OpName(...) : Unit { + /// ... +} +``` + +The `internal` keyword at the beginning clearly indicates that this operation is for internal use only. + + +## Locations in documentation + +- Discussed in [Style Guide: Naming Conventions](xref:microsoft.quantum.contributing.style#private-or-internal-names). + +https://docs.microsoft.com/en-us/quantum/resources/contributing/style-guide?tabs=guidance#private-or-internal-names \ No newline at end of file From a1ebbfad953620357b6356358468b8ac18d11b85 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sun, 27 Sep 2020 00:13:52 +0200 Subject: [PATCH 09/19] filled out keywords page --- .../language-ref/language-reference.md | 96 +++++++++++++++++-- 1 file changed, 88 insertions(+), 8 deletions(-) diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index d1a434becc..132256ee61 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -1,5 +1,5 @@ --- -title: Keyword reference +title: Keyword and language reference description: List of keywords and common symbols in the Q# language, with links to their respective pages in documentation author: gillenhaalb ms.author: a-gibec @@ -8,17 +8,97 @@ ms.topic: article uid: microsoft.quantum.lang-ref.main-list --- -# Keyword Reference +# Q# Keyword and Language Reference -This page contains links to information about all Q# language keywords and many common symbols. +This page contains brief descriptions and links to further information about all Q# language keywords and many common symbols. -## Q# Keyword Table +## Keywords + +| |Description| +|----|-----------| +|[`Adj`](xref:microsoft.quantum.lang-ref.adj)|...| +|[`Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|...| +|[`Adjoint`](xref:microsoft.quantum.lang-ref.adjoint)|...| +|[`adjoint`](xref:microsoft.quantum.lang-ref.adjoint-tag)|...| +|[`apply-within`](xref:microsoft.quantum.lang-ref.apply-within)|...| +|[`as`](xref:microsoft.quantum.lang-ref.as)|...| +|[`auto`](xref:microsoft.quantum.lang-ref.auto)|...| +|[`body`](xref:microsoft.quantum.lang-ref.body-tag)|...| +|[`borrowing`](xref:microsoft.quantum.lang-ref.borrowing)|...| +|[`Ctl`](xref:microsoft.quantum.lang-ref.ctl)|...| +|[`Controlled`](xref:microsoft.quantum.lang-ref.controlled)|...| +|[`controlled`](xref:microsoft.quantum.lang-ref.controlled-tag)|...| +|[`Controlled Adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint)|...| +|[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|...| +|[`distribute`](xref:microsoft.quantum.lang-ref.distribute)|...| +|[`elif`](xref:microsoft.quantum.lang-ref.elif)|...| +|[`else`](xref:microsoft.quantum.lang-ref.else)|...| +|[`fail`](xref:microsoft.quantum.lang-ref.fail)|...| +|[`fixup`](xref:microsoft.quantum.lang-ref.fixup)|...| +|[`for`](xref:microsoft.quantum.lang-ref.for)|...| +|[`function`](xref:microsoft.quantum.lang-ref.function)|...| +|[`if`](xref:microsoft.quantum.lang-ref.if)|...| +|[`in`](xref:microsoft.quantum.lang-ref.in)|...| +|[`internal`](xref:microsoft.quantum.lang-ref.internal)|...| +|[`intrinsic`](xref:microsoft.quantum.lang-ref.intrinsic)|...| +|[`invert`](xref:microsoft.quantum.lang-ref.invert)|...| +|[`is`](xref:microsoft.quantum.lang-ref.is)|...| +|[`let`](xref:microsoft.quantum.lang-ref.let)|... +|[`mutable`](xref:microsoft.quantum.lang-ref.mutable)|...| +|[`namespace`](xref:microsoft.quantum.lang-ref.namespace)|...| +|[`new`](xref:microsoft.quantum.lang-ref.new)|...| +|[`newtype`](xref:microsoft.quantum.lang-ref.newtype)|...| +|[`open`](xref:microsoft.quantum.lang-ref.open)|...| +|[`operation`](xref:microsoft.quantum.lang-ref.operation)|...| +|[`repeat-until`](xref:microsoft.quantum.lang-ref.repeat-until)|...| +|[`return`](xref:microsoft.quantum.lang-ref.return)|...| +|[`self`](xref:microsoft.quantum.lang-ref.self)|...| +|[`set`](xref:microsoft.quantum.lang-ref.set)|...| +|[`using`](xref:microsoft.quantum.lang-ref.using)|...| +|[`while`](xref:microsoft.quantum.lang-ref.while)|...| + +## Intrinsic types + +| |Description| +|----|-----------| +|[`BigInt`](xref:microsoft.quantum.lang-ref.bigint)|...| +|[`Bool`](xref:microsoft.quantum.lang-ref.bool)|...| +|[`Double`](xref:microsoft.quantum.lang-ref.double)|...| +|[`Int`](xref:microsoft.quantum.lang-ref.int)|...| +|[`Pauli`](xref:microsoft.quantum.lang-ref.pauli)|...| +|[`Qubit`](xref:microsoft.quantum.lang-ref.qubit)|...| +|[`Range`](xref:microsoft.quantum.lang-ref.range)|...| +|[`Result`](xref:microsoft.quantum.lang-ref.result)|...| +|[`String`](xref:microsoft.quantum.lang-ref.string)|...| +|[`Unit`](xref:microsoft.quantum.lang-ref.unit)|...| + +## Reserved values + +| |Description| +|----|-----------| +|[`False`](xref:microsoft.quantum.lang-ref.false)|...| +|[`One`](xref:microsoft.quantum.lang-ref.one)|...| +|[`PauliI`](xref:microsoft.quantum.lang-ref.paulii)|...| +|[`PauliX`](xref:microsoft.quantum.lang-ref.paulix)|...| +|[`PauliY`](xref:microsoft.quantum.lang-ref.pauliy)|...| +|[`PauliZ`](xref:microsoft.quantum.lang-ref.pauliz)|...| +|[`True`](xref:microsoft.quantum.lang-ref.true)|...| +|[`Zero`](xref:microsoft.quantum.lang-ref.Zero)|...| + +## Attributes + +| |Description| +|----|-----------| +|[`@EntryPoint`](xref:microsoft.quantum.lang-ref.entrypoint)|...| +|[`@Test`](xref:microsoft.quantum.lang-ref.test)|...| + +## Symbols + +|[`_`](xref:microsoft.quantum.lang-ref.partial-app-symb)|...| +|[`->`](xref:microsoft.quantum.lang-ref.fn-signature-symb)|...| +|[`=>`](xref:microsoft.quantum.lang-ref.op-signature-symb)|...| -The following table shows all Q# keywords grouped alphabetically, together with brief descriptions and links to relevant topics that contain more information. -|Keyword|Description|Links| -|-------|-----------|-----| -|`keyword`| description goes here |links to solo page (and page in user guide?)| ## See also From de83966131de2de5a405db2a84b9a1dc9da9788d Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sun, 27 Sep 2020 00:45:42 +0200 Subject: [PATCH 10/19] fixed warnings --- .../language-ref/declaration/internal-ref.md | 4 +--- .../user-guide/language-ref/language-reference.md | 14 ++++++++------ 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/articles/user-guide/language-ref/declaration/internal-ref.md b/articles/user-guide/language-ref/declaration/internal-ref.md index 8df936ee31..a832f5831f 100644 --- a/articles/user-guide/language-ref/declaration/internal-ref.md +++ b/articles/user-guide/language-ref/declaration/internal-ref.md @@ -3,7 +3,7 @@ title: internal description: Keyword reference internal author: gillenhaalb ms.author: a-gibec -ms.date: 20/09/2020 +ms.date: 09/20/2020 ms.topic: article uid: microsoft.quantum.lang-ref.internal --- @@ -32,5 +32,3 @@ The `internal` keyword at the beginning clearly indicates that this operation is ## Locations in documentation - Discussed in [Style Guide: Naming Conventions](xref:microsoft.quantum.contributing.style#private-or-internal-names). - -https://docs.microsoft.com/en-us/quantum/resources/contributing/style-guide?tabs=guidance#private-or-internal-names \ No newline at end of file diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index 132256ee61..7ca1b438f0 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -3,7 +3,7 @@ title: Keyword and language reference description: List of keywords and common symbols in the Q# language, with links to their respective pages in documentation author: gillenhaalb ms.author: a-gibec -ms.date: 20/09/2020 +ms.date: 09/20/2020 ms.topic: article uid: microsoft.quantum.lang-ref.main-list --- @@ -14,7 +14,7 @@ This page contains brief descriptions and links to further information about all ## Keywords -| |Description| +|Keyword|Description| |----|-----------| |[`Adj`](xref:microsoft.quantum.lang-ref.adj)|...| |[`Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|...| @@ -59,7 +59,7 @@ This page contains brief descriptions and links to further information about all ## Intrinsic types -| |Description| +|Type|Description| |----|-----------| |[`BigInt`](xref:microsoft.quantum.lang-ref.bigint)|...| |[`Bool`](xref:microsoft.quantum.lang-ref.bool)|...| @@ -74,7 +74,7 @@ This page contains brief descriptions and links to further information about all ## Reserved values -| |Description| +|Value|Description| |----|-----------| |[`False`](xref:microsoft.quantum.lang-ref.false)|...| |[`One`](xref:microsoft.quantum.lang-ref.one)|...| @@ -83,17 +83,19 @@ This page contains brief descriptions and links to further information about all |[`PauliY`](xref:microsoft.quantum.lang-ref.pauliy)|...| |[`PauliZ`](xref:microsoft.quantum.lang-ref.pauliz)|...| |[`True`](xref:microsoft.quantum.lang-ref.true)|...| -|[`Zero`](xref:microsoft.quantum.lang-ref.Zero)|...| +|[`Zero`](xref:microsoft.quantum.lang-ref.zero)|...| ## Attributes -| |Description| +|Attribute|Description| |----|-----------| |[`@EntryPoint`](xref:microsoft.quantum.lang-ref.entrypoint)|...| |[`@Test`](xref:microsoft.quantum.lang-ref.test)|...| ## Symbols +|Symbol|Description| +|----|-----------| |[`_`](xref:microsoft.quantum.lang-ref.partial-app-symb)|...| |[`->`](xref:microsoft.quantum.lang-ref.fn-signature-symb)|...| |[`=>`](xref:microsoft.quantum.lang-ref.op-signature-symb)|...| From b66be9cf2760b218655c4023ae27a53992a8ad17 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Sun, 27 Sep 2020 00:49:19 +0200 Subject: [PATCH 11/19] added to TOC --- articles/user-guide/language-ref/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index add22ca044..1609eb3b03 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -1,5 +1,7 @@ expanded: true items: + - name: Keyword/symbol lists + href: language-reference.md - name: Types items: - name: Primitive types From deef252086dd63d91f9e5ecf42fed33a9cf820c4 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 29 Sep 2020 16:44:04 +0200 Subject: [PATCH 12/19] filled out main list page. brought "is" into "is Adj", etc. --- .../callables/signature/adj-ctl-ref.md | 6 +- .../callables/signature/adj-ref.md | 4 +- .../callables/signature/ctl-ref.md | 4 +- .../callables/signature/is-ref.md | 13 -- .../language-ref/language-reference.md | 148 +++++++++++------- articles/user-guide/language-ref/toc.yml | 8 +- 6 files changed, 104 insertions(+), 79 deletions(-) delete mode 100644 articles/user-guide/language-ref/callables/signature/is-ref.md diff --git a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md index 18a65cce00..c01bf3fff2 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md @@ -1,5 +1,5 @@ --- -title: 'Adj + Ctl' +title: 'is Adj + Ctl' description: Keyword reference 'Adj + Ctl' author: gillenhaalb ms.author: a-gibec @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.adj-ctl --- -# `Adj + Ctl` +# `is Adj + Ctl` -fill \ No newline at end of file +Equivalent to `is Ctl + Adj`. \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/adj-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ref.md index 8b6ea4b90b..bee7c4d777 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ref.md @@ -1,5 +1,5 @@ --- -title: Adj +title: is Adj description: Keyword reference Adj author: gillenhaalb ms.author: a-gibec @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.adj --- -# `Adj` +# `is Adj` fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/ctl-ref.md b/articles/user-guide/language-ref/callables/signature/ctl-ref.md index e98a5461a0..44c1241c6b 100644 --- a/articles/user-guide/language-ref/callables/signature/ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/ctl-ref.md @@ -1,5 +1,5 @@ --- -title: Ctl +title: is Ctl description: Keyword reference Ctl author: gillenhaalb ms.author: a-gibec @@ -8,6 +8,6 @@ ms.topic: article uid: microsoft.quantum.lang-ref.ctl --- -# `Ctl` +# `is Ctl` fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/is-ref.md b/articles/user-guide/language-ref/callables/signature/is-ref.md deleted file mode 100644 index 6eac9d4044..0000000000 --- a/articles/user-guide/language-ref/callables/signature/is-ref.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: is -description: Keyword reference is -author: gillenhaalb -ms.author: a-gibec -ms.date: 05/09/2020 -ms.topic: article -uid: microsoft.quantum.lang-ref.is ---- - -# `is` - -fill \ No newline at end of file diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index 7ca1b438f0..39edb07d6a 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -16,46 +16,84 @@ This page contains brief descriptions and links to further information about all |Keyword|Description| |----|-----------| -|[`Adj`](xref:microsoft.quantum.lang-ref.adj)|...| -|[`Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|...| -|[`Adjoint`](xref:microsoft.quantum.lang-ref.adjoint)|...| -|[`adjoint`](xref:microsoft.quantum.lang-ref.adjoint-tag)|...| -|[`apply-within`](xref:microsoft.quantum.lang-ref.apply-within)|...| -|[`as`](xref:microsoft.quantum.lang-ref.as)|...| -|[`auto`](xref:microsoft.quantum.lang-ref.auto)|...| -|[`body`](xref:microsoft.quantum.lang-ref.body-tag)|...| -|[`borrowing`](xref:microsoft.quantum.lang-ref.borrowing)|...| -|[`Ctl`](xref:microsoft.quantum.lang-ref.ctl)|...| -|[`Controlled`](xref:microsoft.quantum.lang-ref.controlled)|...| -|[`controlled`](xref:microsoft.quantum.lang-ref.controlled-tag)|...| -|[`Controlled Adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint)|...| -|[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|...| -|[`distribute`](xref:microsoft.quantum.lang-ref.distribute)|...| -|[`elif`](xref:microsoft.quantum.lang-ref.elif)|...| -|[`else`](xref:microsoft.quantum.lang-ref.else)|...| -|[`fail`](xref:microsoft.quantum.lang-ref.fail)|...| -|[`fixup`](xref:microsoft.quantum.lang-ref.fixup)|...| -|[`for`](xref:microsoft.quantum.lang-ref.for)|...| -|[`function`](xref:microsoft.quantum.lang-ref.function)|...| -|[`if`](xref:microsoft.quantum.lang-ref.if)|...| -|[`in`](xref:microsoft.quantum.lang-ref.in)|...| -|[`internal`](xref:microsoft.quantum.lang-ref.internal)|...| -|[`intrinsic`](xref:microsoft.quantum.lang-ref.intrinsic)|...| -|[`invert`](xref:microsoft.quantum.lang-ref.invert)|...| -|[`is`](xref:microsoft.quantum.lang-ref.is)|...| -|[`let`](xref:microsoft.quantum.lang-ref.let)|... -|[`mutable`](xref:microsoft.quantum.lang-ref.mutable)|...| -|[`namespace`](xref:microsoft.quantum.lang-ref.namespace)|...| -|[`new`](xref:microsoft.quantum.lang-ref.new)|...| -|[`newtype`](xref:microsoft.quantum.lang-ref.newtype)|...| -|[`open`](xref:microsoft.quantum.lang-ref.open)|...| -|[`operation`](xref:microsoft.quantum.lang-ref.operation)|...| -|[`repeat-until`](xref:microsoft.quantum.lang-ref.repeat-until)|...| -|[`return`](xref:microsoft.quantum.lang-ref.return)|...| -|[`self`](xref:microsoft.quantum.lang-ref.self)|...| -|[`set`](xref:microsoft.quantum.lang-ref.set)|...| -|[`using`](xref:microsoft.quantum.lang-ref.using)|...| -|[`while`](xref:microsoft.quantum.lang-ref.while)|...| + +|[`Adjoint`](xref:microsoft.quantum.lang-ref.adjoint)|Operation functor; used to call the adjoint version of an operation.| + +|[`adjoint`](xref:microsoft.quantum.lang-ref.adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's adjoint specialization.| + +|[`apply-within`](xref:microsoft.quantum.lang-ref.apply-within)|Programming structure which allows an operation or statement block to be applied between a sandwich of the standard and adjoint implementations of another operation or statement block.| + +|[`as`](xref:microsoft.quantum.lang-ref.as)|Used in an `open` statement to define a short name for a namespace.| + +|[`auto`](xref:microsoft.quantum.lang-ref.auto)|Generation directive indicating that the compiler should select an appropriate directive to apply when generating an operation specialization.| + +|[`body`](xref:microsoft.quantum.lang-ref.body-tag)|Specialization tag used to explicitly define the implementation of an operation's standard version (called when no functors are applied).| + +|[`borrowing`](xref:microsoft.quantum.lang-ref.borrowing)|Used to allocate qubits for temporary use, which do not need to be in a specific state. Compare to `using`, which allocates fresh qubits in $\ket{0}$.| + +|[`Controlled`](xref:microsoft.quantum.lang-ref.controlled)|Operation functor; used to call the controlled version of an operation.| + +|[`controlled`](xref:microsoft.quantum.lang-ref.controlled-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled specialization.| + +|[`Controlled Adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint)|Operation functor; used to call the controlled adjoint version of an operation.| + +|[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled adjoint specialization. *Equivalent to `adjoint controlled`.*| + +|[`distribute`](xref:microsoft.quantum.lang-ref.distribute)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `controlled` and `controlled adjoint` specializations.| + +|[`elif`](xref:microsoft.quantum.lang-ref.elif)|Indicates an *else-if* clause, to be evaluated if a preceding *if* condition was *false*.| + +|[`else`](xref:microsoft.quantum.lang-ref.else)|Indicates an *else* block, which will be run if, to be evaluated if the preceding *if* condition was *false* (in addition to any *else-if* conditions).| + +|[`fail`](xref:microsoft.quantum.lang-ref.fail)|Ends the run of an operation and returns an error message to the caller.| + +|[`fixup`](xref:microsoft.quantum.lang-ref.fixup)|Optional block to be run after each failed repetiton of a `repeat-until` loop.| + +|[`for`](xref:microsoft.quantum.lang-ref.for)|Supports iteration over an integer range or an array. Used in conjunction with `in`.| + +|[`function`](xref:microsoft.quantum.lang-ref.function)|Marks the declaration of a new function.| + +|[`if`](xref:microsoft.quantum.lang-ref.if)|Followed by a Boolean expression, supports conditional processing.| + +|[`in`](xref:microsoft.quantum.lang-ref.in)|Supports iteration over an integer range or an array. Used in conjunction with `for`.| + +|[`internal`](xref:microsoft.quantum.lang-ref.internal)|When declaring an `operation`, `function`, or `newtype`, used to indicate that it is for internal use only, and not a part of the public API.| + +|[`intrinsic`](xref:microsoft.quantum.lang-ref.intrinsic)|Generation directive indicating that the target machine provides an operation specialization.| + +|[`invert`](xref:microsoft.quantum.lang-ref.invert)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `adjoint` and `controlled adjoint` specializations.| + +|[`is Adj`](xref:microsoft.quantum.lang-ref.adj)|Annotation to the signature of an operation being defined; declares the existence of an adjoint specialization. Thus the `Adjoint` functor can be used when calling the operation.| + +|[`is Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled adjoint specialization. Thus the `Controlled Adjoint` functor can be used when calling the operation. *Equivalent to `is Ctl + Adj`.*| + +|[`is Ctl`](xref:microsoft.quantum.lang-ref.ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled specialization. Thus the `Controlled` functor can be used when calling the operation.| + +|[`let`](xref:microsoft.quantum.lang-ref.let)|Used to bind a value to an immutable variable. Compare to `mutable`, which allows rebinding.| + +|[`mutable`](xref:microsoft.quantum.lang-ref.mutable)|Used to create a mutable variable which can be rebound using `set`.| + +|[`namespace`](xref:microsoft.quantum.lang-ref.namespace)|Marks the declaration of a namespace within a Q# file; directly precedes the namespace name.| + +|[`new`](xref:microsoft.quantum.lang-ref.new)|Used to create a new array of a given length and element-type.| + +|[`newtype`](xref:microsoft.quantum.lang-ref.newtype)|Marks the declaration of a new user-defined type.| + +|[`open`](xref:microsoft.quantum.lang-ref.open)|Directive used to import all types and callables defined within a certain namespace.| + +|[`operation`](xref:microsoft.quantum.lang-ref.operation)|Marks the declaration of a new operation.| + +|[`repeat-until`](xref:microsoft.quantum.lang-ref.repeat-until)|Programming structure supporting the quantum-specific *repeat-until-success* pattern. Runs the *repeat* loop body until a Boolean expression evaluates to `True`. Can be supplemented with a `fixup` block, which runs after each failed repetition.| + +|[`return`](xref:microsoft.quantum.lang-ref.return)|Ends the run of an operation or function and returns a value to the caller. Not required in callables which return `Unit`.| + +|[`self`](xref:microsoft.quantum.lang-ref.self)|Generation directive indicating that the `adjoint` specialization of an operation is the same as the `body` implementation. Can be used with `adjoint` and `adjoint controlled` specializations.| + +|[`set`](xref:microsoft.quantum.lang-ref.set)|Used to rebind a mutable variable.| + +|[`using`](xref:microsoft.quantum.lang-ref.using)|Used to allocate new qubits for use in a statement block.| + +|[`while`](xref:microsoft.quantum.lang-ref.while)|Supports running a statement block until an expression evaluates to `True`. Only to be used within *functions*, while the quantum-specific `repeat-until` loops should be used inside *operations*.| ## Intrinsic types @@ -74,31 +112,33 @@ This page contains brief descriptions and links to further information about all ## Reserved values -|Value|Description| +|Value|Type| |----|-----------| -|[`False`](xref:microsoft.quantum.lang-ref.false)|...| -|[`One`](xref:microsoft.quantum.lang-ref.one)|...| -|[`PauliI`](xref:microsoft.quantum.lang-ref.paulii)|...| -|[`PauliX`](xref:microsoft.quantum.lang-ref.paulix)|...| -|[`PauliY`](xref:microsoft.quantum.lang-ref.pauliy)|...| -|[`PauliZ`](xref:microsoft.quantum.lang-ref.pauliz)|...| -|[`True`](xref:microsoft.quantum.lang-ref.true)|...| -|[`Zero`](xref:microsoft.quantum.lang-ref.zero)|...| +|[`True`](xref:microsoft.quantum.lang-ref.true)|`Bool`| +|[`False`](xref:microsoft.quantum.lang-ref.false)|`Bool`| +|[`Zero`](xref:microsoft.quantum.lang-ref.zero)|`Result`| +|[`One`](xref:microsoft.quantum.lang-ref.one)|`Result`| +|[`PauliI`](xref:microsoft.quantum.lang-ref.paulii)|`Pauli`| +|[`PauliX`](xref:microsoft.quantum.lang-ref.paulix)|`Pauli`| +|[`PauliY`](xref:microsoft.quantum.lang-ref.pauliy)|`Pauli`| +|[`PauliZ`](xref:microsoft.quantum.lang-ref.pauliz)|`Pauli`| + + ## Attributes |Attribute|Description| |----|-----------| -|[`@EntryPoint`](xref:microsoft.quantum.lang-ref.entrypoint)|...| -|[`@Test`](xref:microsoft.quantum.lang-ref.test)|...| +|[`@EntryPoint`](xref:microsoft.quantum.lang-ref.entrypoint)|Used when running Q# directly via the command line interface. Marks an operation as that which will be run upon the `dotnet run` command.| +|[`@Test`](xref:microsoft.quantum.lang-ref.test)|Marks an operation or function as a unit test to be run on a specific target machine. Can be used with any function that has no inputs or returns (i.e. simply `Unit`).| ## Symbols |Symbol|Description| |----|-----------| -|[`_`](xref:microsoft.quantum.lang-ref.partial-app-symb)|...| -|[`->`](xref:microsoft.quantum.lang-ref.fn-signature-symb)|...| -|[`=>`](xref:microsoft.quantum.lang-ref.op-signature-symb)|...| +|[`_`](xref:microsoft.quantum.lang-ref.partial-app-symb)|Used in partial application.| +|[`->`](xref:microsoft.quantum.lang-ref.fn-signature-symb)|Describes the signature of a *function*.| +|[`=>`](xref:microsoft.quantum.lang-ref.op-signature-symb)|Describes the signature of an *operation*.| diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 1609eb3b03..717ffc7fef 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -78,13 +78,11 @@ href: callables/functors/controlled-adjoint-ref.md - name: Signatures items: - - name: is - href: callables/signature/is-ref.md - - name: Ctl + - name: is Ctl href: callables/signature/ctl-ref.md - - name: Adj + - name: is Adj href: callables/signature/adj-ref.md - - name: 'Adj + Ctl' + - name: 'is Adj + Ctl' href: callables/signature/adj-ctl-ref.md - name: '=> (operation)' href: callables/signature/op-signature-symb-ref.md From a8e9414b4b9424bb553f0425baac604d303a3301 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 29 Sep 2020 18:48:11 +0200 Subject: [PATCH 13/19] lines --- .../language-ref/language-reference.md | 39 ------------------- 1 file changed, 39 deletions(-) diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index 39edb07d6a..5da4922159 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -16,83 +16,44 @@ This page contains brief descriptions and links to further information about all |Keyword|Description| |----|-----------| - |[`Adjoint`](xref:microsoft.quantum.lang-ref.adjoint)|Operation functor; used to call the adjoint version of an operation.| - |[`adjoint`](xref:microsoft.quantum.lang-ref.adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's adjoint specialization.| - |[`apply-within`](xref:microsoft.quantum.lang-ref.apply-within)|Programming structure which allows an operation or statement block to be applied between a sandwich of the standard and adjoint implementations of another operation or statement block.| - |[`as`](xref:microsoft.quantum.lang-ref.as)|Used in an `open` statement to define a short name for a namespace.| - |[`auto`](xref:microsoft.quantum.lang-ref.auto)|Generation directive indicating that the compiler should select an appropriate directive to apply when generating an operation specialization.| - |[`body`](xref:microsoft.quantum.lang-ref.body-tag)|Specialization tag used to explicitly define the implementation of an operation's standard version (called when no functors are applied).| - |[`borrowing`](xref:microsoft.quantum.lang-ref.borrowing)|Used to allocate qubits for temporary use, which do not need to be in a specific state. Compare to `using`, which allocates fresh qubits in $\ket{0}$.| - |[`Controlled`](xref:microsoft.quantum.lang-ref.controlled)|Operation functor; used to call the controlled version of an operation.| - |[`controlled`](xref:microsoft.quantum.lang-ref.controlled-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled specialization.| - |[`Controlled Adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint)|Operation functor; used to call the controlled adjoint version of an operation.| - |[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled adjoint specialization. *Equivalent to `adjoint controlled`.*| - |[`distribute`](xref:microsoft.quantum.lang-ref.distribute)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `controlled` and `controlled adjoint` specializations.| - |[`elif`](xref:microsoft.quantum.lang-ref.elif)|Indicates an *else-if* clause, to be evaluated if a preceding *if* condition was *false*.| - |[`else`](xref:microsoft.quantum.lang-ref.else)|Indicates an *else* block, which will be run if, to be evaluated if the preceding *if* condition was *false* (in addition to any *else-if* conditions).| - |[`fail`](xref:microsoft.quantum.lang-ref.fail)|Ends the run of an operation and returns an error message to the caller.| - |[`fixup`](xref:microsoft.quantum.lang-ref.fixup)|Optional block to be run after each failed repetiton of a `repeat-until` loop.| - |[`for`](xref:microsoft.quantum.lang-ref.for)|Supports iteration over an integer range or an array. Used in conjunction with `in`.| - |[`function`](xref:microsoft.quantum.lang-ref.function)|Marks the declaration of a new function.| - |[`if`](xref:microsoft.quantum.lang-ref.if)|Followed by a Boolean expression, supports conditional processing.| - |[`in`](xref:microsoft.quantum.lang-ref.in)|Supports iteration over an integer range or an array. Used in conjunction with `for`.| - |[`internal`](xref:microsoft.quantum.lang-ref.internal)|When declaring an `operation`, `function`, or `newtype`, used to indicate that it is for internal use only, and not a part of the public API.| - |[`intrinsic`](xref:microsoft.quantum.lang-ref.intrinsic)|Generation directive indicating that the target machine provides an operation specialization.| - |[`invert`](xref:microsoft.quantum.lang-ref.invert)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `adjoint` and `controlled adjoint` specializations.| - |[`is Adj`](xref:microsoft.quantum.lang-ref.adj)|Annotation to the signature of an operation being defined; declares the existence of an adjoint specialization. Thus the `Adjoint` functor can be used when calling the operation.| - |[`is Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled adjoint specialization. Thus the `Controlled Adjoint` functor can be used when calling the operation. *Equivalent to `is Ctl + Adj`.*| - |[`is Ctl`](xref:microsoft.quantum.lang-ref.ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled specialization. Thus the `Controlled` functor can be used when calling the operation.| - |[`let`](xref:microsoft.quantum.lang-ref.let)|Used to bind a value to an immutable variable. Compare to `mutable`, which allows rebinding.| - |[`mutable`](xref:microsoft.quantum.lang-ref.mutable)|Used to create a mutable variable which can be rebound using `set`.| - |[`namespace`](xref:microsoft.quantum.lang-ref.namespace)|Marks the declaration of a namespace within a Q# file; directly precedes the namespace name.| - |[`new`](xref:microsoft.quantum.lang-ref.new)|Used to create a new array of a given length and element-type.| - |[`newtype`](xref:microsoft.quantum.lang-ref.newtype)|Marks the declaration of a new user-defined type.| - |[`open`](xref:microsoft.quantum.lang-ref.open)|Directive used to import all types and callables defined within a certain namespace.| - |[`operation`](xref:microsoft.quantum.lang-ref.operation)|Marks the declaration of a new operation.| - |[`repeat-until`](xref:microsoft.quantum.lang-ref.repeat-until)|Programming structure supporting the quantum-specific *repeat-until-success* pattern. Runs the *repeat* loop body until a Boolean expression evaluates to `True`. Can be supplemented with a `fixup` block, which runs after each failed repetition.| - |[`return`](xref:microsoft.quantum.lang-ref.return)|Ends the run of an operation or function and returns a value to the caller. Not required in callables which return `Unit`.| - |[`self`](xref:microsoft.quantum.lang-ref.self)|Generation directive indicating that the `adjoint` specialization of an operation is the same as the `body` implementation. Can be used with `adjoint` and `adjoint controlled` specializations.| - |[`set`](xref:microsoft.quantum.lang-ref.set)|Used to rebind a mutable variable.| - |[`using`](xref:microsoft.quantum.lang-ref.using)|Used to allocate new qubits for use in a statement block.| - |[`while`](xref:microsoft.quantum.lang-ref.while)|Supports running a statement block until an expression evaluates to `True`. Only to be used within *functions*, while the quantum-specific `repeat-until` loops should be used inside *operations*.| ## Intrinsic types From dd356d6e49abc87b41f810788664d25a031aac0b Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 29 Sep 2020 18:56:00 +0200 Subject: [PATCH 14/19] mention hyperlink --- articles/user-guide/language-ref/language-reference.md | 1 + 1 file changed, 1 insertion(+) diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index 5da4922159..f93f253bcc 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -11,6 +11,7 @@ uid: microsoft.quantum.lang-ref.main-list # Q# Keyword and Language Reference This page contains brief descriptions and links to further information about all Q# language keywords and many common symbols. +Each keyword is hyperlinked to its own dedicated page where you will find more details and examples of its use. ## Keywords From 0c91a45785571c6361515a2dc1fe0739fda225be Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 6 Oct 2020 16:39:38 +0200 Subject: [PATCH 15/19] links to qsharp-language repo pages --- .../language-ref/attributes/entrypoint-ref.md | 5 ++++- .../user-guide/language-ref/attributes/test-ref.md | 5 ++++- .../language-ref/binding-assignment/let-ref.md | 4 +++- .../language-ref/binding-assignment/mutable-ref.md | 4 +++- .../language-ref/binding-assignment/set-ref.md | 4 +++- .../language-ref/callables/functors/adjoint-ref.md | 4 +++- .../callables/functors/controlled-adjoint-ref.md | 4 +++- .../callables/functors/controlled-ref.md | 4 +++- .../op-specializations/directives/auto-ref.md | 2 +- .../op-specializations/directives/distribute-ref.md | 2 +- .../op-specializations/directives/intrinsic-ref.md | 2 +- .../op-specializations/directives/invert-ref.md | 2 +- .../op-specializations/directives/self-ref.md | 2 +- .../op-specializations/tags/adjoint-tag-ref.md | 2 +- .../op-specializations/tags/body-tag-ref.md | 4 +++- .../tags/controlled-adjoint-tag-ref.md | 2 +- .../op-specializations/tags/controlled-tag-ref.md | 2 +- .../language-ref/callables/partial-app-symb-ref.md | 9 ++++++++- .../user-guide/language-ref/callables/return-ref.md | 4 +++- .../language-ref/callables/signature/adj-ctl-ref.md | 4 +++- .../language-ref/callables/signature/adj-ref.md | 2 +- .../language-ref/callables/signature/ctl-ref.md | 2 +- .../language-ref/control-flow/apply-within-ref.md | 4 +++- .../user-guide/language-ref/control-flow/elif-ref.md | 2 +- .../user-guide/language-ref/control-flow/else-ref.md | 2 +- .../user-guide/language-ref/control-flow/fail-ref.md | 4 +++- .../language-ref/control-flow/fixup-ref.md | 4 +++- .../user-guide/language-ref/control-flow/for-ref.md | 4 +++- .../user-guide/language-ref/control-flow/if-ref.md | 2 +- .../user-guide/language-ref/control-flow/in-ref.md | 4 +++- .../language-ref/control-flow/repeat-until-ref.md | 2 +- .../language-ref/control-flow/while-ref.md | 4 +++- .../language-ref/declaration/function-ref.md | 12 +++++++++++- .../language-ref/declaration/internal-ref.md | 5 ++++- .../language-ref/declaration/newtype-ref.md | 6 +++++- .../language-ref/declaration/operation-ref.md | 8 +++++++- .../language-ref/namespace/namespace-ref.md | 6 +++++- .../user-guide/language-ref/qubits/borrowing-ref.md | 4 +++- articles/user-guide/language-ref/qubits/using-ref.md | 4 +++- articles/user-guide/language-ref/types/bigint-ref.md | 4 +++- articles/user-guide/language-ref/types/bool-ref.md | 4 +++- articles/user-guide/language-ref/types/double-ref.md | 4 +++- articles/user-guide/language-ref/types/int-ref.md | 4 +++- articles/user-guide/language-ref/types/pauli-ref.md | 6 +++++- articles/user-guide/language-ref/types/qubit-ref.md | 6 +++++- articles/user-guide/language-ref/types/range-ref.md | 4 +++- articles/user-guide/language-ref/types/result-ref.md | 7 ++++++- articles/user-guide/language-ref/types/string-ref.md | 4 +++- articles/user-guide/language-ref/types/unit-ref.md | 4 +++- 49 files changed, 150 insertions(+), 49 deletions(-) diff --git a/articles/user-guide/language-ref/attributes/entrypoint-ref.md b/articles/user-guide/language-ref/attributes/entrypoint-ref.md index 71e9d9c3fc..8a2663fde0 100644 --- a/articles/user-guide/language-ref/attributes/entrypoint-ref.md +++ b/articles/user-guide/language-ref/attributes/entrypoint-ref.md @@ -10,4 +10,7 @@ uid: microsoft.quantum.lang-ref.entrypoint # `@EntryPoint` -fill \ No newline at end of file +fill + + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/5_Attributes.md#attributes \ No newline at end of file diff --git a/articles/user-guide/language-ref/attributes/test-ref.md b/articles/user-guide/language-ref/attributes/test-ref.md index 63ae0629b5..d2c2b1968a 100644 --- a/articles/user-guide/language-ref/attributes/test-ref.md +++ b/articles/user-guide/language-ref/attributes/test-ref.md @@ -10,4 +10,7 @@ uid: microsoft.quantum.lang-ref.test # `@Test` -fill \ No newline at end of file +fill + + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/5_Attributes.md#attributes \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/let-ref.md b/articles/user-guide/language-ref/binding-assignment/let-ref.md index b92bec9638..673f22a847 100644 --- a/articles/user-guide/language-ref/binding-assignment/let-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/let-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.let # `let` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/VariableDeclarationsAndReassignments.md#variable-declarations-and-reassignments \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/mutable-ref.md b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md index 0cf07fee4e..88529f2138 100644 --- a/articles/user-guide/language-ref/binding-assignment/mutable-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/mutable-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.mutable # `mutable` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/VariableDeclarationsAndReassignments.md#variable-declarations-and-reassignments \ No newline at end of file diff --git a/articles/user-guide/language-ref/binding-assignment/set-ref.md b/articles/user-guide/language-ref/binding-assignment/set-ref.md index 840fa2ad07..6e35828a20 100644 --- a/articles/user-guide/language-ref/binding-assignment/set-ref.md +++ b/articles/user-guide/language-ref/binding-assignment/set-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.set # `set` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/VariableDeclarationsAndReassignments.md#variable-declarations-and-reassignments \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md index e06653c46e..4ed02249ad 100644 --- a/articles/user-guide/language-ref/callables/functors/adjoint-ref.md +++ b/articles/user-guide/language-ref/callables/functors/adjoint-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.adjoint # `Adjoint` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/FunctorApplication.md#functor-application \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md index a801178351..a5b7a92aac 100644 --- a/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md +++ b/articles/user-guide/language-ref/callables/functors/controlled-adjoint-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.controlled-adjoint # `Controlled Adjoint` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/FunctorApplication.md#functor-application \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/functors/controlled-ref.md b/articles/user-guide/language-ref/callables/functors/controlled-ref.md index 45f11aa0ea..3c9698b4ee 100644 --- a/articles/user-guide/language-ref/callables/functors/controlled-ref.md +++ b/articles/user-guide/language-ref/callables/functors/controlled-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.controlled # `Controlled` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/FunctorApplication.md#functor-application \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md index e0c31c49fa..8a3cbc9025 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/auto-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.auto # `auto` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md index 3a78587082..66cb484c38 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/distribute-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.distribute # `distribute` -fill \ No newline at end of file +fillhttps://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md index 2b929d5d4f..deb4d43418 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/intrinsic-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.intrinsic # `intrinsic` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md index 1f2f6263f0..8a66ff6990 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/invert-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.invert # `invert` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md index 6d5562a6c6..c616a7a293 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/directives/self-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.self # `self` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md index 55cd986329..7e6148aed4 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/adjoint-tag-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.adjoint-tag # `adjoint` (Specialization Tag) -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md index 59de49a787..82e5751d07 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/body-tag-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.body-tag # `body` (Specialization Tag) -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/3_CallableDeclarations.md#callable-declarations + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md index b5fa0ed163..87dea71bac 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-adjoint-tag-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.controlled-adjoint-tag # `controlled adjoint` (Specialization Tag) -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md index dc3cb7963d..0d778ab514 100644 --- a/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md +++ b/articles/user-guide/language-ref/callables/op-specializations/tags/controlled-tag-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.controlled-tag # `controlled` (Specialization Tag) -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md index c22198b0de..b3a3bef5f9 100644 --- a/articles/user-guide/language-ref/callables/partial-app-symb-ref.md +++ b/articles/user-guide/language-ref/callables/partial-app-symb-ref.md @@ -10,4 +10,11 @@ uid: microsoft.quantum.lang-ref.partial-app-symb # `_` (partial application) -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/PartialApplication.md#partial-application + + + +*Alternative use*: accessing only part of a deconstructed/unwrapped tuple. +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ItemAccessExpressions.md#item-access-for-user-defined-types \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/return-ref.md b/articles/user-guide/language-ref/callables/return-ref.md index 163621502d..6963c4a760 100644 --- a/articles/user-guide/language-ref/callables/return-ref.md +++ b/articles/user-guide/language-ref/callables/return-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.return # `return` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ReturnsAndTermination.md#return-statement \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md index c01bf3fff2..57287d126a 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ctl-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.adj-ctl # `is Adj + Ctl` -Equivalent to `is Ctl + Adj`. \ No newline at end of file +Equivalent to `is Ctl + Adj`. + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/OperationsAndFunctions.md#operation-characteristics \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/adj-ref.md b/articles/user-guide/language-ref/callables/signature/adj-ref.md index bee7c4d777..09e3fe5939 100644 --- a/articles/user-guide/language-ref/callables/signature/adj-ref.md +++ b/articles/user-guide/language-ref/callables/signature/adj-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.adj # `is Adj` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/OperationsAndFunctions.md#operation-characteristics \ No newline at end of file diff --git a/articles/user-guide/language-ref/callables/signature/ctl-ref.md b/articles/user-guide/language-ref/callables/signature/ctl-ref.md index 44c1241c6b..1846196731 100644 --- a/articles/user-guide/language-ref/callables/signature/ctl-ref.md +++ b/articles/user-guide/language-ref/callables/signature/ctl-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.ctl # `is Ctl` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/OperationsAndFunctions.md#operation-characteristics \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/apply-within-ref.md b/articles/user-guide/language-ref/control-flow/apply-within-ref.md index 1631743200..0ce132bf6f 100644 --- a/articles/user-guide/language-ref/control-flow/apply-within-ref.md +++ b/articles/user-guide/language-ref/control-flow/apply-within-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.apply-within # `apply-within` (conjugation) -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/Conjugations.md#conjugations \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/elif-ref.md b/articles/user-guide/language-ref/control-flow/elif-ref.md index c9016a975a..aed4a33c90 100644 --- a/articles/user-guide/language-ref/control-flow/elif-ref.md +++ b/articles/user-guide/language-ref/control-flow/elif-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.elif # `elif` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalBranching.md#conditional-branching \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/else-ref.md b/articles/user-guide/language-ref/control-flow/else-ref.md index 9889bbac5d..65aa03f0f2 100644 --- a/articles/user-guide/language-ref/control-flow/else-ref.md +++ b/articles/user-guide/language-ref/control-flow/else-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.else # `else` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalBranching.md#conditional-branching \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/fail-ref.md b/articles/user-guide/language-ref/control-flow/fail-ref.md index 6ec4a15eb1..f2bc747980 100644 --- a/articles/user-guide/language-ref/control-flow/fail-ref.md +++ b/articles/user-guide/language-ref/control-flow/fail-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.fail # `fail` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ReturnsAndTermination.md#fail-statement \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/fixup-ref.md b/articles/user-guide/language-ref/control-flow/fixup-ref.md index 9869c6c79b..0145e9c010 100644 --- a/articles/user-guide/language-ref/control-flow/fixup-ref.md +++ b/articles/user-guide/language-ref/control-flow/fixup-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.fixup # `fixup` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalLoops.md#conditional-loops \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/for-ref.md b/articles/user-guide/language-ref/control-flow/for-ref.md index 620121d35a..d5f31a38a8 100644 --- a/articles/user-guide/language-ref/control-flow/for-ref.md +++ b/articles/user-guide/language-ref/control-flow/for-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.for # `for` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/Iterations.md#iterations \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/if-ref.md b/articles/user-guide/language-ref/control-flow/if-ref.md index b002e15b47..12d2eddad7 100644 --- a/articles/user-guide/language-ref/control-flow/if-ref.md +++ b/articles/user-guide/language-ref/control-flow/if-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.if # `if` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalBranching.md#conditional-branching \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/in-ref.md b/articles/user-guide/language-ref/control-flow/in-ref.md index b81c81ec57..980c76c6f0 100644 --- a/articles/user-guide/language-ref/control-flow/in-ref.md +++ b/articles/user-guide/language-ref/control-flow/in-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.in # `in` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/Iterations.md#iterations \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/repeat-until-ref.md b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md index 8f0a4f56f5..c1bca65db7 100644 --- a/articles/user-guide/language-ref/control-flow/repeat-until-ref.md +++ b/articles/user-guide/language-ref/control-flow/repeat-until-ref.md @@ -10,4 +10,4 @@ uid: microsoft.quantum.lang-ref.repeat-until # `repeat-until` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalLoops.md#conditional-loops \ No newline at end of file diff --git a/articles/user-guide/language-ref/control-flow/while-ref.md b/articles/user-guide/language-ref/control-flow/while-ref.md index 6ec6f0d4d8..2ae038627c 100644 --- a/articles/user-guide/language-ref/control-flow/while-ref.md +++ b/articles/user-guide/language-ref/control-flow/while-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.while # `while` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/ConditionalLoops.md#conditional-loops \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/function-ref.md b/articles/user-guide/language-ref/declaration/function-ref.md index df7b02277f..36f7cab75c 100644 --- a/articles/user-guide/language-ref/declaration/function-ref.md +++ b/articles/user-guide/language-ref/declaration/function-ref.md @@ -10,4 +10,14 @@ uid: microsoft.quantum.lang-ref.function # `function` -fill \ No newline at end of file +## Example + +## Further details + +### QDK documentation +- + + +### Q# language repository +- [Callable Declarations](https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/3_CallableDeclarations.md#callable-declarations) +- [Operations and Functions](https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/OperationsAndFunctions.md#operations-and-functions) \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/internal-ref.md b/articles/user-guide/language-ref/declaration/internal-ref.md index a832f5831f..e82465e532 100644 --- a/articles/user-guide/language-ref/declaration/internal-ref.md +++ b/articles/user-guide/language-ref/declaration/internal-ref.md @@ -31,4 +31,7 @@ The `internal` keyword at the beginning clearly indicates that this operation is ## Locations in documentation -- Discussed in [Style Guide: Naming Conventions](xref:microsoft.quantum.contributing.style#private-or-internal-names). +- [Style Guide: Naming Conventions](xref:microsoft.quantum.contributing.style#private-or-internal-names). + + +- Q# language repository: [Access Modifiers](https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/6_AccessModifiers.md#access-modifiers) \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/newtype-ref.md b/articles/user-guide/language-ref/declaration/newtype-ref.md index f2662cccc1..05706f5660 100644 --- a/articles/user-guide/language-ref/declaration/newtype-ref.md +++ b/articles/user-guide/language-ref/declaration/newtype-ref.md @@ -10,4 +10,8 @@ uid: microsoft.quantum.lang-ref.newtype # `newtype` -fill \ No newline at end of file +## Example + +## More details +- *QDK documentation*: +- *Q# language repository*: [Type Declarations](https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/2_TypeDeclarations.md#type-declarations) \ No newline at end of file diff --git a/articles/user-guide/language-ref/declaration/operation-ref.md b/articles/user-guide/language-ref/declaration/operation-ref.md index ca1cf582dc..fbc506fbab 100644 --- a/articles/user-guide/language-ref/declaration/operation-ref.md +++ b/articles/user-guide/language-ref/declaration/operation-ref.md @@ -10,4 +10,10 @@ uid: microsoft.quantum.lang-ref.operation # `operation` -fill \ No newline at end of file +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/TypeParameterizations.md#type-parameterizations + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/OperationsAndFunctions.md#operations-and-functions + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/3_CallableDeclarations.md#callable-declarations + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/4_SpecializationDeclarations.md#specialization-declarations \ No newline at end of file diff --git a/articles/user-guide/language-ref/namespace/namespace-ref.md b/articles/user-guide/language-ref/namespace/namespace-ref.md index 6d63f44e60..9934aadf58 100644 --- a/articles/user-guide/language-ref/namespace/namespace-ref.md +++ b/articles/user-guide/language-ref/namespace/namespace-ref.md @@ -10,4 +10,8 @@ uid: microsoft.quantum.lang-ref.namespace # `namespace` -fill \ No newline at end of file +## Example + +## More details +- *QDK documentation*: +- *Q# language repository*: [Namespaces](https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/1_ProgramStructure/1_Namespaces.md#namespaces) diff --git a/articles/user-guide/language-ref/qubits/borrowing-ref.md b/articles/user-guide/language-ref/qubits/borrowing-ref.md index 8cf52fb9b4..a19b679fc7 100644 --- a/articles/user-guide/language-ref/qubits/borrowing-ref.md +++ b/articles/user-guide/language-ref/qubits/borrowing-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.borrowing # `borrowing` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/QuantumMemoryManagement.md#quantum-memory-management \ No newline at end of file diff --git a/articles/user-guide/language-ref/qubits/using-ref.md b/articles/user-guide/language-ref/qubits/using-ref.md index 9e95167087..905a270c61 100644 --- a/articles/user-guide/language-ref/qubits/using-ref.md +++ b/articles/user-guide/language-ref/qubits/using-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.using # `using` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/2_Statements/QuantumMemoryManagement.md#quantum-memory-management \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/bigint-ref.md b/articles/user-guide/language-ref/types/bigint-ref.md index 502d6f790c..6fa14dac57 100644 --- a/articles/user-guide/language-ref/types/bigint-ref.md +++ b/articles/user-guide/language-ref/types/bigint-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.bigint # `BigInt` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/bool-ref.md b/articles/user-guide/language-ref/types/bool-ref.md index f8310f4bcd..1bfa3ba1cb 100644 --- a/articles/user-guide/language-ref/types/bool-ref.md +++ b/articles/user-guide/language-ref/types/bool-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.bool # `Bool` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/double-ref.md b/articles/user-guide/language-ref/types/double-ref.md index bb71f1e773..ca8f79a98d 100644 --- a/articles/user-guide/language-ref/types/double-ref.md +++ b/articles/user-guide/language-ref/types/double-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.double # `Double` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/int-ref.md b/articles/user-guide/language-ref/types/int-ref.md index ce5d4a84bb..83483eff4a 100644 --- a/articles/user-guide/language-ref/types/int-ref.md +++ b/articles/user-guide/language-ref/types/int-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.int # `Int` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/pauli-ref.md b/articles/user-guide/language-ref/types/pauli-ref.md index f39fddffd5..582a3c5b0a 100644 --- a/articles/user-guide/language-ref/types/pauli-ref.md +++ b/articles/user-guide/language-ref/types/pauli-ref.md @@ -10,4 +10,8 @@ uid: microsoft.quantum.lang-ref.pauli # `Pauli` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/QuantumDataTypes.md#quantum-specific-data-types + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/qubit-ref.md b/articles/user-guide/language-ref/types/qubit-ref.md index da1fc34e9a..d8d336763a 100644 --- a/articles/user-guide/language-ref/types/qubit-ref.md +++ b/articles/user-guide/language-ref/types/qubit-ref.md @@ -10,4 +10,8 @@ uid: microsoft.quantum.lang-ref.qubit # `Qubit` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/QuantumDataTypes.md#quantum-specific-data-types + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/range-ref.md b/articles/user-guide/language-ref/types/range-ref.md index a15f9930a7..cfadd89470 100644 --- a/articles/user-guide/language-ref/types/range-ref.md +++ b/articles/user-guide/language-ref/types/range-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.range # `Range` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/result-ref.md b/articles/user-guide/language-ref/types/result-ref.md index 69274679d3..2afbc28f6a 100644 --- a/articles/user-guide/language-ref/types/result-ref.md +++ b/articles/user-guide/language-ref/types/result-ref.md @@ -10,4 +10,9 @@ uid: microsoft.quantum.lang-ref.result # `Result` -fill \ No newline at end of file +fill + + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/4_TypeSystem/QuantumDataTypes.md#quantum-specific-data-types + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/string-ref.md b/articles/user-guide/language-ref/types/string-ref.md index 4707bb6b63..e5ebef211c 100644 --- a/articles/user-guide/language-ref/types/string-ref.md +++ b/articles/user-guide/language-ref/types/string-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.string # `String` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file diff --git a/articles/user-guide/language-ref/types/unit-ref.md b/articles/user-guide/language-ref/types/unit-ref.md index ba3877550b..17c1230410 100644 --- a/articles/user-guide/language-ref/types/unit-ref.md +++ b/articles/user-guide/language-ref/types/unit-ref.md @@ -10,4 +10,6 @@ uid: microsoft.quantum.lang-ref.unit # `Unit` -fill \ No newline at end of file +fill + +https://github.com/microsoft/qsharp-language/blob/main/Specifications/Language/3_Expressions/ValueLiterals.md#literals \ No newline at end of file From a433c5f1ec6c4dacb361077c3daf430c1564839d Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 6 Oct 2020 17:32:31 +0200 Subject: [PATCH 16/19] equiv to --- articles/user-guide/language-ref/language-reference.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/user-guide/language-ref/language-reference.md b/articles/user-guide/language-ref/language-reference.md index f93f253bcc..d6b351c5fe 100644 --- a/articles/user-guide/language-ref/language-reference.md +++ b/articles/user-guide/language-ref/language-reference.md @@ -27,7 +27,7 @@ Each keyword is hyperlinked to its own dedicated page where you will find more d |[`Controlled`](xref:microsoft.quantum.lang-ref.controlled)|Operation functor; used to call the controlled version of an operation.| |[`controlled`](xref:microsoft.quantum.lang-ref.controlled-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled specialization.| |[`Controlled Adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint)|Operation functor; used to call the controlled adjoint version of an operation.| -|[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled adjoint specialization. *Equivalent to `adjoint controlled`.*| +|[`controlled adjoint`](xref:microsoft.quantum.lang-ref.controlled-adjoint-tag)|Specialization tag used to explicitly define the implementation of an operation's controlled adjoint specialization. *Equivalent to* `adjoint controlled`.| |[`distribute`](xref:microsoft.quantum.lang-ref.distribute)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `controlled` and `controlled adjoint` specializations.| |[`elif`](xref:microsoft.quantum.lang-ref.elif)|Indicates an *else-if* clause, to be evaluated if a preceding *if* condition was *false*.| |[`else`](xref:microsoft.quantum.lang-ref.else)|Indicates an *else* block, which will be run if, to be evaluated if the preceding *if* condition was *false* (in addition to any *else-if* conditions).| @@ -41,7 +41,7 @@ Each keyword is hyperlinked to its own dedicated page where you will find more d |[`intrinsic`](xref:microsoft.quantum.lang-ref.intrinsic)|Generation directive indicating that the target machine provides an operation specialization.| |[`invert`](xref:microsoft.quantum.lang-ref.invert)|Generation directive indicating how the compiler should generate an operation specialization. Can be used with `adjoint` and `controlled adjoint` specializations.| |[`is Adj`](xref:microsoft.quantum.lang-ref.adj)|Annotation to the signature of an operation being defined; declares the existence of an adjoint specialization. Thus the `Adjoint` functor can be used when calling the operation.| -|[`is Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled adjoint specialization. Thus the `Controlled Adjoint` functor can be used when calling the operation. *Equivalent to `is Ctl + Adj`.*| +|[`is Adj + Ctl`](xref:microsoft.quantum.lang-ref.adj-ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled adjoint specialization. Thus the `Controlled Adjoint` functor can be used when calling the operation. *Equivalent to* `is Ctl + Adj`.| |[`is Ctl`](xref:microsoft.quantum.lang-ref.ctl)|Annotation to the signature of an operation being defined; declares the existence of a controlled specialization. Thus the `Controlled` functor can be used when calling the operation.| |[`let`](xref:microsoft.quantum.lang-ref.let)|Used to bind a value to an immutable variable. Compare to `mutable`, which allows rebinding.| |[`mutable`](xref:microsoft.quantum.lang-ref.mutable)|Used to create a mutable variable which can be rebound using `set`.| From 96222eabaf6f3848df5af6264c0ce28aa7114525 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 20 Oct 2020 13:43:37 +0200 Subject: [PATCH 17/19] point EntryPoint and Test attributes to API from TOC --- articles/user-guide/language-ref/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 717ffc7fef..8c629406ae 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -151,6 +151,6 @@ - name: Attributes items: - name: '@EntryPoint' - href: attributes/entrypoint-ref.md + href: microsoft.quantum.core.entrypoint - name: '@Test' - href: attributes/test-ref.md \ No newline at end of file + href: microsoft.quantum.diagnostics.test \ No newline at end of file From a516dd271dbbf6988520348b69e7f2ab9bfb9159 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 20 Oct 2020 13:48:58 +0200 Subject: [PATCH 18/19] test xref link #2 --- articles/user-guide/language-ref/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 8c629406ae..3aa48e64d7 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -151,6 +151,6 @@ - name: Attributes items: - name: '@EntryPoint' - href: microsoft.quantum.core.entrypoint + href: @microsoft.quantum.core.entrypoint - name: '@Test' - href: microsoft.quantum.diagnostics.test \ No newline at end of file + href: @microsoft.quantum.diagnostics.test \ No newline at end of file From 4a0e1bfcfe341ac074ba72f63932016c13f18a09 Mon Sep 17 00:00:00 2001 From: GillenhaalBeck Date: Tue, 20 Oct 2020 13:50:54 +0200 Subject: [PATCH 19/19] attemp #3 --- articles/user-guide/language-ref/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/user-guide/language-ref/toc.yml b/articles/user-guide/language-ref/toc.yml index 3aa48e64d7..0430bee163 100644 --- a/articles/user-guide/language-ref/toc.yml +++ b/articles/user-guide/language-ref/toc.yml @@ -151,6 +151,6 @@ - name: Attributes items: - name: '@EntryPoint' - href: @microsoft.quantum.core.entrypoint + href: xref:microsoft.quantum.core.entrypoint - name: '@Test' - href: @microsoft.quantum.diagnostics.test \ No newline at end of file + href: xref:microsoft.quantum.diagnostics.test \ No newline at end of file