qsharp-lang 1.10.2-dev → 1.10.3-dev

package/docs/Std.Math/Sinh.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.Sinh
 title: Sinh function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# Sinh function: Returns the hyperbolic sine of the specified angle."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/SmallestFixedPoint.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.SmallestFixedPoint
 title: SmallestFixedPoint function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# SmallestFixedPoint function: Returns the smallest representable number for specific fixed point dimensions."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/Sqrt.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.Sqrt
 title: Sqrt function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# Sqrt function: Returns the square root of a specified number."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/SquaredNorm.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.SquaredNorm
 title: SquaredNorm function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# SquaredNorm function: Returns the squared 2-norm of a vector."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/Tan.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.Tan
 title: Tan function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# Tan function: Returns the tangent of the specified angle."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/Tanh.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.Tanh
 title: Tanh function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# Tanh function: Returns the hyperbolic tangent of the specified angle."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/TimesC.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.TimesC
 title: TimesC function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# TimesC function: Returns the product of two inputs of type `Complex`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/TimesCP.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.TimesCP
 title: TimesCP function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# TimesCP function: Returns the product of two inputs of type `ComplexPolar`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/TrailingZeroCountI.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.TrailingZeroCountI
 title: TrailingZeroCountI function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# TrailingZeroCountI function: For a non-zero integer `a`, returns the number of trailing zero bits in the binary representation of `a`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/TrailingZeroCountL.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.TrailingZeroCountL
 title: TrailingZeroCountL function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# TrailingZeroCountL function: For a non-zero integer `a`, returns the number of trailing zero bits in the binary representation of `a`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/Truncate.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Math.Truncate
 title: Truncate function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# Truncate function: Returns the integral part of a number. For example: Truncate(3.7) = 3; Truncate(-3.7) = -3"
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Math/index.md

@@ -0,0 +1,109 @@
+---
+uid: Qdk.Std.Math-toc
+title: Std.Math namespace
+description: Table of contents for the Q# Math namespace
+author: {AUTHOR}
+ms.author: {MS_AUTHOR}
+ms.date: 11/15/2024
+ms.topic: landing-page
+---
+
+# Std.Math
+
+The Std.Math namespace contains the following items:
+
+| Name | Description |
+|------|-------------|
+| [AbsComplex](xref:Qdk.Std.Math.AbsComplex) | Returns the absolute value of a complex number of type `Complex`. |
+| [AbsComplexPolar](xref:Qdk.Std.Math.AbsComplexPolar) | Returns the absolute value of a complex number of type `ComplexPolar`. |
+| [AbsD](xref:Qdk.Std.Math.AbsD) | Returns the absolute value of a double-precision floating-point number. |
+| [AbsI](xref:Qdk.Std.Math.AbsI) | Returns the absolute value of an integer. |
+| [AbsL](xref:Qdk.Std.Math.AbsL) | Returns the absolute value of a big integer. |
+| [AbsSquaredComplex](xref:Qdk.Std.Math.AbsSquaredComplex) | Returns the squared absolute value of a complex number of type `Complex`. |
+| [AbsSquaredComplexPolar](xref:Qdk.Std.Math.AbsSquaredComplexPolar) | Returns the squared absolute value of a complex number of type `ComplexPolar`. |
+| [ApproximateFactorial](xref:Qdk.Std.Math.ApproximateFactorial) | Returns an approximate factorial of a given number. |
+| [ArcCos](xref:Qdk.Std.Math.ArcCos) | Returns the angle whose cosine is the specified number. |
+| [ArcCosh](xref:Qdk.Std.Math.ArcCosh) | Computes the inverse hyperbolic cosine of a number. |
+| [ArcSin](xref:Qdk.Std.Math.ArcSin) | Returns the angle whose sine is the specified number. |
+| [ArcSinh](xref:Qdk.Std.Math.ArcSinh) | Computes the inverse hyperbolic sine of a number. |
+| [ArcTan](xref:Qdk.Std.Math.ArcTan) | Returns the angle whose tangent is the specified number. |
+| [ArcTan2](xref:Qdk.Std.Math.ArcTan2) | Returns the angle whose tangent is the quotient of two specified numbers. |
+| [ArcTanh](xref:Qdk.Std.Math.ArcTanh) | Computes the inverse hyperbolic tangent of a number. |
+| [ArgComplex](xref:Qdk.Std.Math.ArgComplex) | Returns the phase of a complex number of type `Complex`. |
+| [ArgComplexPolar](xref:Qdk.Std.Math.ArgComplexPolar) | Returns the phase of a complex number of type `ComplexPolar`. |
+| [Binom](xref:Qdk.Std.Math.Binom) | Returns the approximate binomial coefficient of two integers. |
+| [BitSizeI](xref:Qdk.Std.Math.BitSizeI) | For a non-negative integer `a`, returns the number of bits required to represent `a`. NOTE: This function returns the smallest n such that a < 2^n. |
+| [BitSizeL](xref:Qdk.Std.Math.BitSizeL) | For a non-negative integer `a`, returns the number of bits required to represent `a`. NOTE: This function returns the smallest n such that a < 2^n. |
+| [Ceiling](xref:Qdk.Std.Math.Ceiling) | Returns the smallest integer greater than or equal to the specified number. For example: Ceiling(3.1) = 4; Ceiling(-3.7) = -3 |
+| [Complex](xref:Qdk.Std.Math.Complex) | Represents a complex number by its real and imaginary components. The first element of the tuple is the real component, the second one - the imaginary component. |
+| [ComplexPolar](xref:Qdk.Std.Math.ComplexPolar) | Represents a complex number in polar form. The polar representation of a complex number is c = r⋅𝑒^(t𝑖). |
+| [ContinuedFractionConvergentI](xref:Qdk.Std.Math.ContinuedFractionConvergentI) | Finds the continued fraction convergent closest to `fraction` with the denominator less or equal to `denominatorBound` Using process similar to this: https://nrich.maths.org/1397 |
+| [ContinuedFractionConvergentL](xref:Qdk.Std.Math.ContinuedFractionConvergentL) | Finds the continued fraction convergent closest to `fraction` with the denominator less or equal to `denominatorBound` Using process similar to this: https://nrich.maths.org/1397 |
+| [Cos](xref:Qdk.Std.Math.Cos) | Returns the cosine of the specified angle. |
+| [Cosh](xref:Qdk.Std.Math.Cosh) | Returns the hyperbolic cosine of the specified angle. |
+| [DivRemI](xref:Qdk.Std.Math.DivRemI) | Divides one Integer value by another, returns the result and the remainder as a tuple. |
+| [DivRemL](xref:Qdk.Std.Math.DivRemL) | Divides one BigInteger value by another, returns the result and the remainder as a tuple. |
+| [DividedByC](xref:Qdk.Std.Math.DividedByC) | Returns the quotient of two inputs of type `Complex`. |
+| [DividedByCP](xref:Qdk.Std.Math.DividedByCP) | Returns the quotient of two inputs of type `ComplexPolar`. |
+| [E](xref:Qdk.Std.Math.E) | Returns a double-precision approximation of the mathematical constant 𝒆 ≈ 2.7182818284590452354 |
+| [ExpModI](xref:Qdk.Std.Math.ExpModI) | Returns an integer raised to a given power, with respect to a given modulus. I.e. (expBase^power) % modulus. |
+| [ExpModL](xref:Qdk.Std.Math.ExpModL) | Returns an integer raised to a given power, with respect to a given modulus. I.e. (expBase^power) % modulus. |
+| [ExtendedGreatestCommonDivisorI](xref:Qdk.Std.Math.ExtendedGreatestCommonDivisorI) | Returns a tuple (u,v) such that u*a+v*b=GCD(a,b) Note: GCD is always positive except that GCD(0,0)=0. |
+| [ExtendedGreatestCommonDivisorL](xref:Qdk.Std.Math.ExtendedGreatestCommonDivisorL) | Returns a tuple (u,v) such that u*a+v*b=GCD(a,b) Note: GCD is always positive except that GCD(0,0)=0. |
+| [FactorialI](xref:Qdk.Std.Math.FactorialI) | Returns the factorial of a given number. |
+| [FactorialL](xref:Qdk.Std.Math.FactorialL) | Returns the factorial of a given number. |
+| [Floor](xref:Qdk.Std.Math.Floor) | Returns the largest integer less than or equal to the specified number. For example: Floor(3.7) = 3; Floor(-3.1) = -4 |
+| [GreatestCommonDivisorI](xref:Qdk.Std.Math.GreatestCommonDivisorI) | Computes the greatest common divisor of two integers. Note: GCD is always positive except that GCD(0,0)=0. |
+| [GreatestCommonDivisorL](xref:Qdk.Std.Math.GreatestCommonDivisorL) | Computes the greatest common divisor of two integers. Note: GCD is always positive except that GCD(0,0)=0. |
+| [HammingWeightI](xref:Qdk.Std.Math.HammingWeightI) | Returns the number of 1 bits in the binary representation of integer `n`. |
+| [InverseModI](xref:Qdk.Std.Math.InverseModI) | Returns the multiplicative inverse of a modular integer. |
+| [InverseModL](xref:Qdk.Std.Math.InverseModL) | Returns the multiplicative inverse of a modular integer. |
+| [IsCoprimeI](xref:Qdk.Std.Math.IsCoprimeI) | Returns if two integers are co-prime. |
+| [IsCoprimeL](xref:Qdk.Std.Math.IsCoprimeL) | Returns if two integers are co-prime. |
+| [IsInfinite](xref:Qdk.Std.Math.IsInfinite) | Returns whether a given floating-point value is either positive or negative infinity. |
+| [IsNaN](xref:Qdk.Std.Math.IsNaN) | Returns whether a given floating-point value is not a number (i.e. is NaN). |
+| [LargestFixedPoint](xref:Qdk.Std.Math.LargestFixedPoint) | Returns the largest representable number for specific fixed point dimensions. |
+| [Lg](xref:Qdk.Std.Math.Lg) | Computes the base-2 logarithm of a number. |
+| [Log](xref:Qdk.Std.Math.Log) | Returns the natural (base _e_) logarithm of a specified number. |
+| [Log10](xref:Qdk.Std.Math.Log10) | Returns the base-10 logarithm of a specified number. |
+| [LogFactorialD](xref:Qdk.Std.Math.LogFactorialD) | Returns the approximate natural logarithm of the factorial of a given integer. |
+| [LogGammaD](xref:Qdk.Std.Math.LogGammaD) | Returns the natural logarithm of the gamma function (aka the log-gamma function). |
+| [LogOf2](xref:Qdk.Std.Math.LogOf2) | Returns a double-precision approximation of the constant ㏑2 ≈ 0.6931471805599453 |
+| [Max](xref:Qdk.Std.Math.Max) | Given an array of integers, returns the largest element. |
+| [MaxD](xref:Qdk.Std.Math.MaxD) | Returns the larger of two specified numbers. |
+| [MaxI](xref:Qdk.Std.Math.MaxI) | Returns the larger of two specified numbers. |
+| [MaxL](xref:Qdk.Std.Math.MaxL) | Returns the larger of two specified numbers. |
+| [Min](xref:Qdk.Std.Math.Min) | Given an array of integers, returns the smallest element. |
+| [MinD](xref:Qdk.Std.Math.MinD) | Returns the smaller of two specified numbers. |
+| [MinI](xref:Qdk.Std.Math.MinI) | Returns the smaller of two specified numbers. |
+| [MinL](xref:Qdk.Std.Math.MinL) | Returns the smaller of two specified numbers. |
+| [MinusC](xref:Qdk.Std.Math.MinusC) | Returns the difference between two inputs of type `Complex`. |
+| [MinusCP](xref:Qdk.Std.Math.MinusCP) | Returns the difference between two inputs of type `ComplexPolar`. |
+| [ModulusI](xref:Qdk.Std.Math.ModulusI) | Computes the canonical residue of `value` modulo `modulus`. The result is always in the range 0..modulus-1 even for negative numbers. |
+| [ModulusL](xref:Qdk.Std.Math.ModulusL) | Computes the canonical residue of `value` modulo `modulus`. The result is always in the range 0..modulus-1 even for negative numbers. |
+| [NegationC](xref:Qdk.Std.Math.NegationC) | Returns the unary negation of an input of type `Complex`. |
+| [NegationCP](xref:Qdk.Std.Math.NegationCP) | Returns the unary negation of an input of type `ComplexPolar` |
+| [PI](xref:Qdk.Std.Math.PI) | Returns a double-precision approximation of the matematical constant 𝝅 ≈ 3.14159265358979323846 |
+| [PNorm](xref:Qdk.Std.Math.PNorm) | Returns the `L(p)` norm of a vector of `Double`s.  That is, given an array x of type `Double[]`, this returns the p-norm \|x̄\|ₚ= (∑(xᵢ)ᵖ)¹ᐟᵖ. |
+| [PNormalized](xref:Qdk.Std.Math.PNormalized) | Normalizes a vector of `Double`s in the `L(p)` norm.  That is, given an array x of type `Double[]`, this returns an array where all elements are divided by the p-norm \|x̄\|ₚ. Function leaves array with norm 0 unchanged. |
+| [PlusC](xref:Qdk.Std.Math.PlusC) | Returns the sum of two inputs of type `Complex`. |
+| [PlusCP](xref:Qdk.Std.Math.PlusCP) | Returns the sum of two inputs of type `ComplexPolar`. |
+| [PowC](xref:Qdk.Std.Math.PowC) | Returns a number raised to a given power of type `Complex`. Note that this is a multi-valued function, but only one value is returned. |
+| [PowCP](xref:Qdk.Std.Math.PowCP) | Returns a number raised to a given power of type `ComplexPolar`. Note that this is a multi-valued function, but only one value is returned. |
+| [RealMod](xref:Qdk.Std.Math.RealMod) | Computes the modulus between two real numbers. |
+| [Round](xref:Qdk.Std.Math.Round) | Returns the nearest integer to the specified number. For example: Round(3.7) = 4; Round(-3.7) = -4 |
+| [SignD](xref:Qdk.Std.Math.SignD) | Returns -1, 0 or +1 that indicates the sign of a number. |
+| [SignI](xref:Qdk.Std.Math.SignI) | Returns -1, 0 or +1 that indicates the sign of a number. |
+| [SignL](xref:Qdk.Std.Math.SignL) | Returns -1, 0 or +1 that indicates the sign of a number. |
+| [Sin](xref:Qdk.Std.Math.Sin) | Returns the sine of the specified angle. |
+| [Sinh](xref:Qdk.Std.Math.Sinh) | Returns the hyperbolic sine of the specified angle. |
+| [SmallestFixedPoint](xref:Qdk.Std.Math.SmallestFixedPoint) | Returns the smallest representable number for specific fixed point dimensions. |
+| [Sqrt](xref:Qdk.Std.Math.Sqrt) | Returns the square root of a specified number. |
+| [SquaredNorm](xref:Qdk.Std.Math.SquaredNorm) | Returns the squared 2-norm of a vector. |
+| [Tan](xref:Qdk.Std.Math.Tan) | Returns the tangent of the specified angle. |
+| [Tanh](xref:Qdk.Std.Math.Tanh) | Returns the hyperbolic tangent of the specified angle. |
+| [TimesC](xref:Qdk.Std.Math.TimesC) | Returns the product of two inputs of type `Complex`. |
+| [TimesCP](xref:Qdk.Std.Math.TimesCP) | Returns the product of two inputs of type `ComplexPolar`. |
+| [TrailingZeroCountI](xref:Qdk.Std.Math.TrailingZeroCountI) | For a non-zero integer `a`, returns the number of trailing zero bits in the binary representation of `a`. |
+| [TrailingZeroCountL](xref:Qdk.Std.Math.TrailingZeroCountL) | For a non-zero integer `a`, returns the number of trailing zero bits in the binary representation of `a`. |
+| [Truncate](xref:Qdk.Std.Math.Truncate) | Returns the integral part of a number. For example: Truncate(3.7) = 3; Truncate(-3.7) = -3 |

package/docs/Std.Measurement/MResetEachZ.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MResetEachZ
 title: MResetEachZ operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MResetEachZ operation: Measures each qubit in a given array in the Z basis and resets them to a fixed initial state."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MResetX.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MResetX
 title: MResetX operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MResetX operation: Measures a single qubit in the X basis, and resets it to a fixed initial state following the measurement."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MResetY.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MResetY
 title: MResetY operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MResetY operation: Measures a single qubit in the Y basis, and resets it to a fixed initial state following the measurement."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MResetZ.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MResetZ
 title: MResetZ operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MResetZ operation: Measures a single qubit in the Z basis, and resets it to a fixed initial state following the measurement."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MeasureAllZ.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MeasureAllZ
 title: MeasureAllZ operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MeasureAllZ operation: Jointly measures a register of qubits in the Pauli Z basis."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MeasureEachZ.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MeasureEachZ
 title: MeasureEachZ operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MeasureEachZ operation: Measures each qubit in a given array in the standard basis."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/MeasureInteger.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Measurement.MeasureInteger
 title: MeasureInteger operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# MeasureInteger operation: Measures the content of a quantum register and converts it to an integer. The measurement is performed with respect to the standard computational basis, i.e., the eigenbasis of `PauliZ`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.Measurement/index.md

@@ -0,0 +1,23 @@
+---
+uid: Qdk.Std.Measurement-toc
+title: Std.Measurement namespace
+description: Table of contents for the Q# Measurement namespace
+author: {AUTHOR}
+ms.author: {MS_AUTHOR}
+ms.date: 11/15/2024
+ms.topic: landing-page
+---
+
+# Std.Measurement
+
+The Std.Measurement namespace contains the following items:
+
+| Name | Description |
+|------|-------------|
+| [MResetEachZ](xref:Qdk.Std.Measurement.MResetEachZ) | Measures each qubit in a given array in the Z basis and resets them to a fixed initial state. |
+| [MResetX](xref:Qdk.Std.Measurement.MResetX) | Measures a single qubit in the X basis, and resets it to a fixed initial state following the measurement. |
+| [MResetY](xref:Qdk.Std.Measurement.MResetY) | Measures a single qubit in the Y basis, and resets it to a fixed initial state following the measurement. |
+| [MResetZ](xref:Qdk.Std.Measurement.MResetZ) | Measures a single qubit in the Z basis, and resets it to a fixed initial state following the measurement. |
+| [MeasureAllZ](xref:Qdk.Std.Measurement.MeasureAllZ) | Jointly measures a register of qubits in the Pauli Z basis. |
+| [MeasureEachZ](xref:Qdk.Std.Measurement.MeasureEachZ) | Measures each qubit in a given array in the standard basis. |
+| [MeasureInteger](xref:Qdk.Std.Measurement.MeasureInteger) | Measures the content of a quantum register and converts it to an integer. The measurement is performed with respect to the standard computational basis, i.e., the eigenbasis of `PauliZ`. |

package/docs/Std.Random/DrawRandomBool.md

@@ -0,0 +1,38 @@
+---
+uid: Qdk.Std.Random.DrawRandomBool
+title: DrawRandomBool operation
+description: "Q# DrawRandomBool operation: Given a success probability, returns a single Bernoulli trial that is true with the given probability."
+ms.date: 11/15/2024
+ms.topic: managed-reference
+qsharp.kind: operation
+qsharp.package: __Std__
+qsharp.namespace: Std.Random
+qsharp.name: DrawRandomBool
+qsharp.summary: "Given a success probability, returns a single Bernoulli trial that is true with the given probability."
+---
+
+# DrawRandomBool operation
+
+Fully qualified name: Std.Random.DrawRandomBool
+
+```qsharp
+operation DrawRandomBool(successProbability : Double) : Bool
+```
+
+## Summary
+Given a success probability, returns a single Bernoulli trial
+that is true with the given probability.
+
+## Input
+### successProbability
+The probability with which true should be returned.
+
+## Output
+`true` with probability `successProbability`
+and `false` with probability `1.0 - successProbability`.
+
+## Example
+The following Q# snippet samples flips from a biased coin:
+```qsharp
+let flips = DrawMany(DrawRandomBool, 10, 0.6);
+```

package/docs/Std.Random/DrawRandomDouble.md

@@ -0,0 +1,40 @@
+---
+uid: Qdk.Std.Random.DrawRandomDouble
+title: DrawRandomDouble operation
+description: "Q# DrawRandomDouble operation: Draws a random real number from a uniform distribution in a given inclusive interval. Fails if `max < min`."
+ms.date: 11/15/2024
+ms.topic: managed-reference
+qsharp.kind: operation
+qsharp.package: __Std__
+qsharp.namespace: Std.Random
+qsharp.name: DrawRandomDouble
+qsharp.summary: "Draws a random real number from a uniform distribution in a given inclusive interval. Fails if `max < min`."
+---
+
+# DrawRandomDouble operation
+
+Fully qualified name: Std.Random.DrawRandomDouble
+
+```qsharp
+operation DrawRandomDouble(min : Double, max : Double) : Double
+```
+
+## Summary
+Draws a random real number from a uniform distribution
+in a given inclusive interval. Fails if `max < min`.
+
+## Input
+### min
+The smallest real number to be drawn.
+### max
+The largest real number to be drawn.
+
+## Output
+A random real number in the inclusive interval from `min` to `max` with
+uniform probability.
+
+## Example
+The following Q# snippet randomly draws an angle between 0 and 2π:
+```qsharp
+let angle = DrawRandomDouble(0.0, 2.0 * PI());
+```

package/docs/Std.Random/DrawRandomInt.md

@@ -0,0 +1,40 @@
+---
+uid: Qdk.Std.Random.DrawRandomInt
+title: DrawRandomInt operation
+description: "Q# DrawRandomInt operation: Draws a random integer from a uniform distribution in a given inclusive range. Fails if `max < min`."
+ms.date: 11/15/2024
+ms.topic: managed-reference
+qsharp.kind: operation
+qsharp.package: __Std__
+qsharp.namespace: Std.Random
+qsharp.name: DrawRandomInt
+qsharp.summary: "Draws a random integer from a uniform distribution in a given inclusive range. Fails if `max < min`."
+---
+
+# DrawRandomInt operation
+
+Fully qualified name: Std.Random.DrawRandomInt
+
+```qsharp
+operation DrawRandomInt(min : Int, max : Int) : Int
+```
+
+## Summary
+Draws a random integer from a uniform distribution
+in a given inclusive range. Fails if `max < min`.
+
+## Input
+### min
+The smallest integer to be drawn.
+### max
+The largest integer to be drawn.
+
+## Output
+An integer in the inclusive range from `min` to `max` with uniform
+probability.
+
+## Example
+The following Q# snippet randomly rolls a six-sided die:
+```qsharp
+let roll = DrawRandomInt(1, 6);
+```

package/docs/Std.Random/index.md

@@ -0,0 +1,19 @@
+---
+uid: Qdk.Std.Random-toc
+title: Std.Random namespace
+description: Table of contents for the Q# Random namespace
+author: {AUTHOR}
+ms.author: {MS_AUTHOR}
+ms.date: 11/15/2024
+ms.topic: landing-page
+---
+
+# Std.Random
+
+The Std.Random namespace contains the following items:
+
+| Name | Description |
+|------|-------------|
+| [DrawRandomBool](xref:Qdk.Std.Random.DrawRandomBool) | Given a success probability, returns a single Bernoulli trial that is true with the given probability. |
+| [DrawRandomDouble](xref:Qdk.Std.Random.DrawRandomDouble) | Draws a random real number from a uniform distribution in a given inclusive interval. Fails if `max < min`. |
+| [DrawRandomInt](xref:Qdk.Std.Random.DrawRandomInt) | Draws a random integer from a uniform distribution in a given inclusive range. Fails if `max < min`. |

package/docs/Std.Range/IsRangeEmpty.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Range.IsRangeEmpty
 title: IsRangeEmpty function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# IsRangeEmpty function: Returns true if and only if the input range is empty."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Range/RangeEnd.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Range.RangeEnd
 title: RangeEnd function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# RangeEnd function: Returns the defined end value of the given range, which is not necessarily the last element in the sequence."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Range/RangeReverse.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Range.RangeReverse
 title: RangeReverse function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# RangeReverse function: Returns a new range which is the reverse of the input range."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Range/RangeStart.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Range.RangeStart
 title: RangeStart function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# RangeStart function: Returns the defined start value of the given range."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Range/RangeStep.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.Range.RangeStep
 title: RangeStep function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# RangeStep function: Returns the integer that specifies how the next value of a range is calculated."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.Range/index.md

@@ -0,0 +1,21 @@
+---
+uid: Qdk.Std.Range-toc
+title: Std.Range namespace
+description: Table of contents for the Q# Range namespace
+author: {AUTHOR}
+ms.author: {MS_AUTHOR}
+ms.date: 11/15/2024
+ms.topic: landing-page
+---
+
+# Std.Range
+
+The Std.Range namespace contains the following items:
+
+| Name | Description |
+|------|-------------|
+| [IsRangeEmpty](xref:Qdk.Std.Range.IsRangeEmpty) | Returns true if and only if the input range is empty. |
+| [RangeEnd](xref:Qdk.Std.Range.RangeEnd) | Returns the defined end value of the given range, which is not necessarily the last element in the sequence. |
+| [RangeReverse](xref:Qdk.Std.Range.RangeReverse) | Returns a new range which is the reverse of the input range. |
+| [RangeStart](xref:Qdk.Std.Range.RangeStart) | Returns the defined start value of the given range. |
+| [RangeStep](xref:Qdk.Std.Range.RangeStep) | Returns the integer that specifies how the next value of a range is calculated. |

package/docs/Std.ResourceEstimation/AccountForEstimates.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.AccountForEstimates
 title: AccountForEstimates operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# AccountForEstimates operation: Account for the resource estimates of an unimplemented operation, which were obtained separately. This operation is only available when using resource estimator execution target."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/AuxQubitCount.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.AuxQubitCount
 title: AuxQubitCount function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# AuxQubitCount function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the number of auxiliary qubits is equal to the `amount`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/BeginEstimateCaching.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.BeginEstimateCaching
 title: BeginEstimateCaching function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# BeginEstimateCaching function: Informs the resource estimator of the start of the code fragment for which estimates caching can be done. This function is only available when using resource estimator execution target."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/BeginRepeatEstimates.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.BeginRepeatEstimates
 title: BeginRepeatEstimates operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# BeginRepeatEstimates operation: Instructs the resource estimator to assume that the resources from the call of this operation until a call to `EndRepeatEstimates` are accounted for `count` times, without the need to execute the code that many times. Calls to `BeginRepeatEstimates` and `EndRepeatEstimates` can be nested. A helper operation `RepeatEstimates` allows to call the two functions in a `within` block."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/CczCount.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.CczCount
 title: CczCount function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# CczCount function: Returns a tuple that can be passed to the `AccountForEstimates` operation to specify that the number of the CCZ gates is equal to the `amount`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/EndEstimateCaching.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.EndEstimateCaching
 title: EndEstimateCaching function
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# EndEstimateCaching function: Instructs the resource estimator to stop estimates caching because the code fragment in consideration is over. This function is only available when using resource estimator execution target."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: function
 qsharp.package: __Std__

package/docs/Std.ResourceEstimation/EndRepeatEstimates.md

@@ -1,7 +1,8 @@
 ---
 uid: Qdk.Std.ResourceEstimation.EndRepeatEstimates
 title: EndRepeatEstimates operation
-ms.date: 11/01/2024 12:00:00 AM
+description: "Q# EndRepeatEstimates operation: Companion operation to `BeginRepeatEstimates`."
+ms.date: 11/15/2024
 ms.topic: managed-reference
 qsharp.kind: operation
 qsharp.package: __Std__