Komentáře

Komentáře začínají dvěma lomítky (//) a pokračujte až do konce řádku. Takové koncové komentáře se můžou objevit kdekoli ve zdrojovém kódu. Q# momentálně nepodporuje blokované komentáře.

Komentáře k dokumentaci

Komentáře, které začínají třemi lomítky, ///, jsou zpracovávány speciálně kompilátorem, když se zobrazí před typem nebo volatelnou deklaraci. V takovém případě se jejich obsah bere jako dokumentace k definovanému typu nebo volatelnému, stejně jako u jiných jazyků .NET.

V /// komentářích je text, který se má zobrazit jako součást dokumentace k rozhraní API, formátovaný jako markdown, s různými částmi dokumentace označenými speciálně pojmenovanými hlavičkami. Jako rozšíření Markdownu lze křížové odkazy na operace, funkce a typy struktur v Q# zahrnout pomocí @"<ref target>,", kde <ref target> je nahrazen plně kvalifikovaným názvem odkazovaného objektu kódu. Volitelně může modul dokumentace také podporovat další rozšíření Markdownu.

Například:

/// # Summary
/// Given an operation and a target for that operation,
/// applies the given operation twice.
///
/// # Input
/// ## op
/// The operation to be applied.
/// ## target
/// The target to which the operation is to be applied.
///
/// # Type Parameters
/// ## 'T
/// The type expected by the given operation as its input.
///
/// # Example
/// ```Q#
/// // Should be equivalent to the identity.
/// ApplyTwice(H, qubit);
/// ```
///
/// # See Also
/// - Microsoft.Quantum.Intrinsic.H
operation ApplyTwice<'T>(op : ('T => Unit), target : 'T) : Unit {
    op(target);
    op(target);
}

Q# rozpozná následující názvy jako hlavičky komentářů dokumentace.

• Souhrnné: Krátký souhrn chování funkce nebo operace nebo účelu typu. První odstavec souhrnu slouží k najetí myší. Měl by to být prostý text.
• Popis: Popis chování funkce nebo operace nebo účel typu. Souhrn a popis jsou zřetězeny tak, aby vytvořily vygenerovaný soubor dokumentace pro funkci, operaci nebo typ. Popis může obsahovat vložené symboly a rovnice ve formátu LaTeX.
• Vstupní: Popis vstupní řazené kolekce členů pro operaci nebo funkci. Může obsahovat další dílčí části Markdownu označující každý prvek vstupní řazené kolekce členů.
• výstupní: Popis řazené kolekce členů vrácené operací nebo funkcí.
• parametry typu: Prázdný oddíl, který obsahuje jeden další pododdíl pro každý parametr obecného typu.
• pojmenované položky: Popis pojmenovaných položek v typu struktury. Může obsahovat další pododdíly Markdownu s popisem každé pojmenované položky.
• Příklad: Krátký příklad operace, funkce nebo typu, které se používají.
• Poznámky: Různé prose popisující určitý aspekt operace, funkce nebo typu.
• Viz také: Seznam plně kvalifikovaných názvů označujících související funkce, operace nebo typy struktur.
• Reference: Seznam odkazů a citací pro dokumentovanou položku.