Skip to content
This repository has been archived by the owner on Nov 16, 2023. It is now read-only.

Quantum Random Number Generator Quickstart #574

Merged
merged 79 commits into from
Nov 1, 2019
Merged

Conversation

bromeg
Copy link
Contributor

@bromeg bromeg commented Oct 25, 2019

No description provided.

Megan Brown (QUANTUM) and others added 30 commits July 9, 2019 13:19
…g iqsharp section from getting started into seperate file and included in jupyter & python pages
Co-Authored-By: Chris Granade <cgranade@cgranade.com>
Co-Authored-By: Chris Granade <cgranade@cgranade.com>
@acrolinxatmsft1
Copy link
Collaborator

Acrolinx Scorecards

A minimum Acrolinx score of 80 is required.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Acrolinx
Score
Lowest
Category
Score
Issues Scorecard Processed
articles/TOC.yml 100 100 0 link
articles/quickstarts/qrng.md 83 54 8 link
articles/relnotes/index.md 79 53 124 link

More info about Acrolinx

@opbld32
Copy link

opbld32 commented Oct 25, 2019

Docs Build status updates of commit 5da652c:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/quickstarts/qrng.md ⚠️Warning View (qsharp-preview) Details
articles/TOC.yml ✅Succeeded View (qsharp-preview)
articles/relnotes/index.md ✅Succeeded View (qsharp-preview)

articles/quickstarts/qrng.md

  • [Warning] Author megbrow cannot be recognized in GitHub.
  • Line 17: [Warning] Invalid file link:(~/quickstarts/install).

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

Copy link
Collaborator

@anpaz anpaz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general I like it. Simple and clean.

articles/TOC.yml Outdated
@@ -22,6 +22,8 @@
href: intro-to-katas.md
- name: Quickstarts
items:
- name: Build a quantum random number generator
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the title here should match the title on the page.


Here we introduce the `Qubit` datatype, native to Q#. We can only allocate a `Qubit` with a `using` statement. When it gets allocated a qubit is always in the `Zero` state.

Using the `H` operation, we are able to put our `Qubit` in superposition. To measure a qubit and read its value you use the `M` intrinsic operation.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally, we wouldn't use H but have another operation with a more descriptive name.
I'm fine with M, as it is quickly recognizable as a shortcut for measure, but H is not intuitive (it comes from Hadamard, which is not intuitive either).

Also, we probably want to be more specific, what H does is puts a qubit in state 0 into a superposition of 0 and 1.

@@ -0,0 +1,50 @@
---
title: Create a Quantum Random Number Generator
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would rename this to "Write your First Quantum Program"


## Write a Q# operation

As mentioned in our [What is Quantum Computing?](xref:microsoft.quantum.overview.what) article, a qubit is a unit of quantum information that can be in superposition. When measured, a qubit can only be either 0 or 1, however during execution, the state of the qubit represents the probability of reading either a 0 or a 1 during measurement. This probabilistic state is known as superposition. We can use this probability to generate random numbers.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would move this explanation after the code.

@geduardo geduardo self-requested a review October 30, 2019 19:22
* image

* adding image

* Delete Bloch1.svg

* Add files via upload

* Update qrng.md

* Update qrng.md

* Rename Bloch1.svg to Bloch.svg

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Add files via upload

* Update qrng.md

* Add files via upload

* Update qrng.md

* Typos

* Update qrng.md

* Update qrng.md

* Update qrng.md

* first changes

* Delete Measurement.svg

* Add files via upload

* Add files via upload

* Update qrng.md

* Update articles/quickstarts/qrng.md

Co-Authored-By: Chris Granade <cgranade@gmail.com>

* Update qrng.md

* Update qrng.md

* Update qrng.md

* Update qrng.md
@acrolinxatmsft1
Copy link
Collaborator

Acrolinx Scorecards

A minimum Acrolinx score of 80 is required.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Acrolinx
Score
Lowest
Category
Score
Issues Scorecard Processed
articles/TOC.yml 100 100 0 link
articles/quickstarts/qrng.md 77 48 18 link
articles/relnotes/index.md 79 53 124 link

More info about Acrolinx

@opbld31
Copy link

opbld31 commented Nov 1, 2019

Docs Build status updates of commit f71accd:

✅ Validation status: passed

File Status Preview URL Details
articles/TOC.yml ✅Succeeded View (qsharp-preview)
articles/quickstarts/Bloch.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/H.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/Measurement.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/Measurement2.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/qrng.md ✅Succeeded View (qsharp-preview)
articles/relnotes/index.md ✅Succeeded View (qsharp-preview)

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

@opbld30
Copy link

opbld30 commented Nov 1, 2019

Docs Build status updates of commit 351bd67:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
❌Error Details

  • [Error] Cannot sync git repo to specified state. Please make sure the pull request is mergeable. Details: Git merge results in conflict, repository remote url: https://github.com/MicrosoftDocs/quantum-docs-pr, working directory: W:\xyjx-s, target branch: HEAD, target branch commit: 8a455689a967c07c020d67920a1263d9fca2be7d, source commit: 351bd6725b195bffec518c2ef15b634470568373.

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

@acrolinxatmsft1
Copy link
Collaborator

Acrolinx Scorecards

A minimum Acrolinx score of 80 is required.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Acrolinx
Score
Lowest
Category
Score
Issues Scorecard Processed
articles/TOC.yml 100 100 0 link
articles/how-to-guides/create-qsharp-project.md 92 71 7 link
articles/install-guide/index.md 94 91 5 link
articles/quickstart.md 87 66 35 link
articles/quickstarts/qrng.md 77 48 18 link
articles/relnotes/index.md 79 53 124 link

More info about Acrolinx

@anpaz anpaz marked this pull request as ready for review November 1, 2019 07:16
@acrolinxatmsft1
Copy link
Collaborator

Acrolinx Scorecards

A minimum Acrolinx score of 80 is required.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Acrolinx
Score
Lowest
Category
Score
Issues Scorecard Processed
articles/TOC.yml 100 100 0 link
articles/how-to-guides/create-qsharp-project.md 92 72 7 link
articles/install-guide/index.md 89 77 13 link
articles/quickstart.md 86 64 54 link
articles/quickstarts/qrng.md 77 48 18 link
articles/relnotes/index.md 79 53 124 link

More info about Acrolinx

@opbld34
Copy link

opbld34 commented Nov 1, 2019

Docs Build status updates of commit 2f0be71:

✅ Validation status: passed

File Status Preview URL Details
articles/TOC.yml ✅Succeeded View (qsharp-preview)
articles/how-to-guides/create-qsharp-project.md ✅Succeeded View (qsharp-preview)
articles/install-guide/index.md ✅Succeeded View (qsharp-preview)
articles/media/install-guide-jupyter-simulate.png ✅Succeeded View (qsharp-preview)
articles/quickstart.md ✅Succeeded View (qsharp-preview)
articles/quickstarts/Bloch.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/H.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/Measurement.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/Measurement2.svg ✅Succeeded View (qsharp-preview)
articles/quickstarts/qrng.md ✅Succeeded View (qsharp-preview)
articles/relnotes/index.md ✅Succeeded View (qsharp-preview)

For more details, please refer to the build report.

Note: If you changed an existing file name or deleted a file, broken links in other files to the deleted or renamed file are listed only in the full build report.

@anpaz anpaz merged commit 36e2cb2 into master Nov 1, 2019
bromeg added a commit that referenced this pull request Nov 1, 2019
bromeg pushed a commit that referenced this pull request Nov 1, 2019
* Add create project how-to (#565)

* Simple Grover quickstart (#549)

* minor grammar edits and SEO fix to title (#567)

* Add overview docs (#553)

* Refactor welcome page, and add katas page (#557)

* Update landing page (#566)

* re-title What Is article in concepts (#569)

* Update after review (#568)

* formatting and SEO fixes

* fix heading mismatch

* spelling, grammar

* fixed multiple h1 issue

* heading level fix

* Update what-is-quantum-computing.md

Replace paras per Cathy Palmer and Bettina Heim

* Update what-is-quantum-computing.md

link fix

* Update what-is-quantum-computing.md

link fix

* Landing page fixes (#573)

* remove unnec *the*, lang-locale in link

* samples section

* update to say requires .NET Core SDK 3.0 (#576)

* add a little detail to steps and correct filename (#578)

* add a little detail to steps and correct filename

* little more wordsmithing

* new cards (#577)

* new cards

* new cards

* new cards

* new cards

* YML fix; removed lang-locale from link

* Update articles/install-guide/index.md

Co-Authored-By: Megan B <47067910+bromeg@users.noreply.github.com>

* fix links

* fix links

* fix links2

* fix links3

* updating the description for how to make a new project in VS (#584)

* M44555: Fixing typo Advance/Advanced

Translator has reported possible source content issue. 
Description: Advance should be Advanced

* Tutorial edits (#585)

* tutorial edits

* added ptr to new tutorials

* tutorial edits2

* small edits

* Update articles/overview/what-is-quantum-computing.md

Co-Authored-By: Chris Granade <cgranade@gmail.com>

* Update articles/overview/what-is-quantum-computing.md

Co-Authored-By: Chris Granade <cgranade@gmail.com>

* more edits

* minor edits2

* minor edit3

* minor edits5

* build suggestions

* https

* bloch sphere link

* bloch sphere 2

* 5 question titles

* card edit

* 5 question title2

* fix 5 questions ref

* Update articles/quickstart.md

Co-Authored-By: Chris Granade <cgranade@gmail.com>

* Update articles/overview/how-to-learn-quantum-computing.md

Co-Authored-By: Megan B <47067910+bromeg@users.noreply.github.com>

* Update articles/overview/what-is-qsharp.md

Co-Authored-By: Megan B <47067910+bromeg@users.noreply.github.com>

* Update articles/quickstart.md

Co-Authored-By: Megan B <47067910+bromeg@users.noreply.github.com>

* Update articles/quickstart.md

Co-Authored-By: Megan B <47067910+bromeg@users.noreply.github.com>

* Update articles/welcome.md

Co-Authored-By: Chris Granade <cgranade@gmail.com>

* QuickStart

* Update "Intro to Katas" with more relevant info (#590)

Rewrote the introduction to be less of a project manifest and more of an explanation what is great about the katas, expanded the list with more interesting katas and new tutorials.

* Quantum Random Number Generator Quickstart (#574)

* Updating landing & getting started pages with QRNG & updating Bell title (#594)

* A couple of small bug fixes on tutorials. (#595)

* Fixing spacing.

* Fixes on grover.

* Correct ValueType to ValueTuple (#579)

* Small fixes to QRNG tutorial (#592)

* Update qrng.md

* 1-8 -> 0-7

* Delete Measurement.svg

* Improving acrolinx

* Additional update instructions for .NET 3.0 (#596)

* Getting started

* Added run online sections to getting started page and moved installing iqsharp section from getting started into seperate file and included in jupyter & python pages

* Fixing typo

* updating include file paths

* Updating include files

* Rolling back includes--will debug file paths later (lower priority task)

* Rolling back include (adding IQ# back to getting started page)

* Reformatted getting started landing page

* minor fixes to page

* Updating navigation

* Self contained python installation.

* Links for Python and quickstart.

* extra space

* Update articles/install-guide/index.md

Co-Authored-By: Chris Granade <cgranade@cgranade.com>

* add Q# blog

* add 64-bit requirement note

* IQ# installation install for jupyter and python

* Titles all caps, etc

* Adding IQ# installation instructions in-line.

* Fixing quickstart links.

* Pointing users directly to Jupyter getting started guide.

* Added .NET core requirement for VSCode

* .NEt core requirement & merge conflicts

* Update articles/install-guide/index.md

Co-Authored-By: Chris Granade <cgranade@cgranade.com>

* Updating Jupyter & Python to have IQ# install instructions

* moving Classical Hosts to quickstart

* Update articles/install-guide/jupyter.md

Co-Authored-By: Chris Granade <cgranade@cgranade.com>

* Update articles/install-guide/jupyter.md

Co-Authored-By: Chris Granade <cgranade@cgranade.com>

* Update articles/install-guide/python.md

Co-Authored-By: Chris Granade <cgranade@cgranade.com>

* updated link paths

* updating links in relnotes

* changes to relNotes for 0.8

* updated relNotes, waiting for package #

* added package reference #

* updating relnote for v0.9

* updating relnotes

* updated header style

* added link to Katas

* updating spacing

* Update articles/relnotes/index.md

* Update articles/relnotes/index.md

* Update articles/relnotes/index.md

* updated based on review comments

* relnotes for v0.10

* added version number to code completion

* Update release notes, with release info

* Add update guide to the TOC

* Clarified VS Code workspace restriction

* Update after re-review

* updating relnotes for october release

* updated relnotes with simulation breaking change info

* added links to PRs

* Update articles/relnotes/index.md

Co-Authored-By: Chris Granade <chgranad@microsoft.com>

* Update articles/relnotes/index.md

Co-Authored-By: Chris Granade <chgranad@microsoft.com>

* updated from github PR comments

* updating relnotes based on new release features

* added relnotes for deprecated attributes

* updating relnotes with build number

* updated TOC, getting started page, landing page cards with title updates

* updated titles & welcome content

* small changes to welcome & update instructions for 3.0

* better wording

* accidentally a word

* added new update instructions for project files

* minor fixes

* Update articles/install-guide/update.md

Co-Authored-By: bettinaheim <34236215+bettinaheim@users.noreply.github.com>

* Update articles/install-guide/update.md

Co-Authored-By: bettinaheim <34236215+bettinaheim@users.noreply.github.com>

* Update articles/install-guide/update.md

Co-Authored-By: Andres Paz <anpaz@microsoft.com>

* Update articles/install-guide/update.md

Co-Authored-By: bettinaheim <34236215+bettinaheim@users.noreply.github.com>

* Update articles/install-guide/update.md

Co-Authored-By: bettinaheim <34236215+bettinaheim@users.noreply.github.com>

* Update articles/install-guide/update.md

Co-Authored-By: bettinaheim <34236215+bettinaheim@users.noreply.github.com>

* updates based on PR

* added workspace reload to Jupyter instructions

* updated to specify jupyter cell

* added update to latest VS2019 version

* remove local specific URL

* updating python update instructions

* aded link to updating target framework

* Update articles/install-guide/update.md

Co-Authored-By: Andres Paz <anpaz@microsoft.com>

* pr comment updates

* remove local specific url

* Apply suggestions from code review

* indenting jupyter command

* typo

* removed superfluous steps

* removed local URL

* removed path from project name

* Rel-notes for October release (#581)
@anpaz anpaz deleted the megbrow/QRNGQuickstart branch January 3, 2020 20:03
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet