PrismLibrary/Prism

Add Missing XML Docs

オープン

#1,978 opened on 2019/12/21

 (12 件のコメント) (2 件のリアクション) (0 人の担当者)C# (1,611 件のフォーク)batch import
Good First IssueMAUIUnoWPFhelp wantedroadmap

Repository metrics

Stars
 (6,005 個のスター)
PR merge metrics
 (30d に merged PR はありません)

説明

Summary

Many API's are currently lacking XML docs or have invalid markup. As we begin to explore adding API documentation to the Prism Docs, we need to update the existing codebase with more complete XML docs so that these docs can be generated for the docs site.

HACKTOBERFEST UPDATE

Thank you for joining us for your Hacktoberfest contributions... Please take some time to familiarize yourself with this issue. If you submit PR's for a single method in a single class please expect your PR to be closed as invalid

NOTE

While updated and added XML docs should include Summaries, and information for parameters/return values, it will often be better to ensure that remarks and examples are included as this will make the generated API docs more useful. Additional information on proper doc tags can be found here.

/// <summary>
/// The GetZero method.
/// </summary>
/// <example> 
/// This sample shows how to call the <see cref="GetZero"/> method.
/// <code>
/// class TestClass 
/// {
///     static int Main() 
///     {
///         return GetZero();
///     }
/// }
/// </code>
/// </example>
public static int GetZero()
{
    return 0;
}

コントリビューターガイド