search

MicrosoftDocs / quantum-docs-pr

Sources of the Microsoft Quantum Development Kit documentation
https://docs.microsoft.com/quantum/
Creative Commons Attribution 4.0 International
81 stars 114 forks source link

Probably alright if you already know this stuff. #655

Closed trippalamb closed 4 years ago

trippalamb commented 4 years ago

Probably good if you already know what everything means. There are several keywords and operations that exist on the page that were not in the previous quickstarts that have no indication of what they might be or mean. The comments are not excellent either. I understand that explaining the keywords and procedures might be to much for this tutorial but there is no link to the documentation either. For example "Z()", "Unit is ADj + Ctl", and "Controlled", but there are many more.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

geduardo commented 4 years ago

Thank you very much for the feedback! It is true that Grover's tutorial maybe is a bit advanced for a quick start, but we wanted to showcase a complete code with a popular quantum computing algorithm. If you want to learn more about functors Adj and Ctl take a look here: https://docs.microsoft.com/en-us/quantum/language/type-model?view=qsharp-preview#functors

We plan to create more tutorials to provide a softer and continuous introduction to the QDK. Stay tuned!

trippalamb commented 4 years ago

After looking through the documentation more I have found everything I needed to start to understand how to use q# (and I think it is written very well), but I wanted to clarify what I thought the problem was. The documentation feels very out of order and there should be something on that page to link to the quantum computing concepts section.

On Sat, Jan 11, 2020 at 7:08 PM geduardo notifications@github.com wrote:

Thank you very much for the feedback! It is true that Grover's tutorial maybe is a bit advanced for a quick start, but we wanted to showcase a complete code with a popular quantum computing algorithm. If you want to learn more about functors Adj and Ctl take a look here: https://docs.microsoft.com/en-us/quantum/language/type-model?view=qsharp-preview#functors

We plan to create more tutorials to provide a softer and continuous introduction to the QDK. Stay tuned!

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/MicrosoftDocs/quantum-docs-pr/issues/655?email_source=notifications&email_token=ABHDC33ZKOZVVD6CA4EZNCLQ5JUPDA5CNFSM4KC5XCC2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEIWO34Y#issuecomment-573369843, or unsubscribe https://github.com/notifications/unsubscribe-auth/ABHDC35PR7YFZADO6VLQIGTQ5JUPDANCNFSM4KC5XCCQ .

KittyYeungQ commented 4 years ago

663 will address this.

geduardo commented 4 years ago

I think this is solved with the new user guide.