qsharp

Several katas could have better error messaging:

• Superposition : the test harness could log the actual state of the system after prep vs the expected state before asserting that they are the same (the change would add state prep and logging using DumpMachine to AssertEqualOnZeroState)
• BasicGates : a similar improvement, but a bit more extra code to write a unified test wrapper

Here are some examples:

• Root README is missing machine learning category of samples
• README in algorithms is missing repeat-until-success and sudoku-grover
• [README in diagnostics](https://github.com/microsoft/Quantum/blob/main/samples/diagnostics/RE

Most documentation comments in the compiler only use the <summary> tag. For short comments, this is fine, but in many cases the summary is several paragraphs long and would be easier to read if it used standard documentation tags to structure the information. This is especially important for exceptions - exceptions mentioned in the <summary> tag are easy to miss, whereas the special `<exceptio

The formulas at API page for https://docs.microsoft.com/en-us/qsharp/api/qsharp/microsoft.quantum.preparation.purifiedmixedstatewithdata are also broken, but I couldn't figure out what caused it at a glance.

Originally posted by @tcNickolas in microsoft/QuantumLibraries#484 (comment)

Describe the bug

The QIR Runtime readme lists the required LLVM version as 11.0.0, while the prereq installation script uses version 11.1.0.

Now that Q# + Python can use project files for references, we should add them here so IntelliSense can work better :)

Looking for a Zookeeper who can help manage and drive more algorithms to be implemented in the zoo!

https://github.com/qsharp-community/algorithm-zoo