Create workbooks for the katas/tutorials, part 2

[tcNickolas]

(This issue is the second part of #208)

The katas offer a set of programming exercises on quantum computing and reference solutions to them, but we often hear that it would be helpful to have the solutions explained, with the logic steps necessary to arrive from the problem description to the code spelled out. It is especially important for people who go through the katas on their own, without a study group to support them.

To address this, we came up with the idea of "workbooks" - explanations of the solutions to the tasks offered in the katas/tutorials, written in Jupyter Notebook format. You can check any of the workbooks completed in #208 to get an idea of what the workbooks look like.

Here are the katas and tutorials that don't have a workbook yet and seem like a good fit for one.

• BasicGates (@TonyHoldroyd)
• GraphColoring, part IV triangle-free coloring
• KeyDistribution_BB84 (@devikamehra)
• MagicSquareGame
• MarkingOracles
• PhaseEstimation
• QEC_BitFlipCode
• QFT (@WaywardPhoton)
• RippleCarryAdder (@Parisha-Agrawal)
• SuperdenseCoding
• Teleportation
• TruthTables (tasks 1-8 @olstulo, tasks 9-10 @tcNickolas)
• tutorials/Oracles
• tutorials/RandomNumberGeneration (@ssc1729)

[born-2learn]

I would love to work on them, @tcNickolas. Will it be okay if I move with a slow pace for these?

[tcNickolas]

@born-2learn Sure! Usually I recommend to pick one workbook to work on and claim it, so that if somebody else wants to take another one, they can; once that one is complete, can pick another one if you want, and so on. The #208 took about a year to complete :-) (though it had more workbooks in it)

[born-2learn]

@tcNickolas Alright, I would like to try out the Phase Estimation workbook then.

[WaywardPhoton]

@tcNickolas Is there anything I can work on? I'd be happy to create a workbook for QFT if that is something that would be needed. It seems like there isn't one currently available.

[tcNickolas]

Hi Ana, Absolutely! I'm not aware of anybody else working on the QFT kata workbook, so you're welcome to it! Please let me know if you need any help from me to get started.

…

On Fri, May 28, 2021 at 9:22 PM Ana Madalena ***@***.***> wrote: @tcNickolas <https://github.com/tcNickolas> Is there anything I can work on? I'd be happy to create workbooks for QFT if that is something that would be needed. It seems like there isn't one currently available. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#542 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACNFAAEIR5PIUQH3NBY2U2DTQBTZZANCNFSM4S2RPEBA> .

[WaywardPhoton]

@tcNickolas I'd love some general guidelines on content. I know that the solution already exists (and all I have to do is explain it) but if there is anything specific that explanations are required to have I'd like to know!
Oh! and also, where to submit the notebook when finished :)

[tcNickolas]

The best way to get an idea of how the workbook should look is probably checking out the ones for other katas. Typically we want to explain the way to come to the solution mathematically, and then to highlight some Q# features/library operations that come in handy but can be not obvious for someone who is just getting started with the language.

…

On Sat, May 29, 2021 at 2:51 PM Ana Madalena ***@***.***> wrote: @tcNickolas <https://github.com/tcNickolas> I'd love some general guidelines on content. I know that the solution already exists (and all I have to do is explain it) but if there is anything specific that explanations are required to have I'd like to know! — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#542 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACNFAACJWBVTUQ42F4FTZBTTQFOV7ANCNFSM4S2RPEBA> .

[tcNickolas]

Hi @born-2learn and @WaywardPhoton,
Are you still working on the PhaseEstimation and QFT workbooks, respectively? Let me know if you want to drop them or need any help from me - I finally have a little breathing room compared to the past few months, and hope to catch up on the open source work on the Katas in the next few weeks!

[WaywardPhoton]

Hi, yes, I am almost done the QFT. Has been a busy two weeks with school.
Just doing some research to figure out part 3. I can send you what I have if you want.

[tcNickolas]

@WaywardPhoton
Oh, I forgot we had part 3 in the QFT kata at all! You can definitely skip that one, those are tasks from the Q# Coding Contest #3 and they're pretty advanced. We have writeups of the solutions at https://assets.codeforces.com/rounds/1357/problems-e1e2-2.pdf, so I'll be able to hunt down the sources from which we generated that pdf and to reuse them, or to upload the pdf as a whole and use it as is.

If you have parts 1 and 2, please feel free to send the pull request and I'll take a look next week. We'll deal with part 3 later.

[WaywardPhoton]

Gone ahead and made the pull request. Thanks!