microsoft/Quantum

"Intro to QSharp" samples

Offen

#422 geöffnet am 01.09.2020

Auf GitHub ansehenContributor Guide
 (2 Kommentare) (2 Reaktionen) (0 zugewiesene Personen)Jupyter Notebook (938 Forks)auto 404
Kind-Enhancementgood first issue

Repository-Metriken

Stars
 (4.042 Sterne)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

While the samples serve the purpose of demonstrating the usage of the language, it would be useful to have samples that explicitly demonstrate commonly used QSharp syntax, or even demonstrate more advanced syntax examples, without necessarily producing a useful algorithm. The goal is to make it easy for developers who learn by reading other code to pick up the language quickly.

Some examples:

  • within
  • Partial application
  • Adjoint, Controlled and is Adj + Ctl
  • ApplyToEach
  • Arrays, both 1D and 2D
  • Math, e.g. PowD

Based on contributor discussion.

Contributor Guide

Research-Richtung
Untersuchen Sie vorhandene Beispieldateien im Repository, um das Muster zu verstehen, und erstellen Sie dann neue Beispiele für jedes im Problem aufgeführte Q# Syntaxkonstrukt. Stellen Sie sicher, dass der Code kompiliert und Kommentare enthält.
Tech Stack
Keine
Domain
documentation
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Git
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
75