Skip to content

Add XML documentation to DatePickerDialog.UpdateDate(DateTime)#12130

Open
jonathanpeppers with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-finder-add-xml-documentation
Open

Add XML documentation to DatePickerDialog.UpdateDate(DateTime)#12130
jonathanpeppers with Copilot wants to merge 2 commits into
mainfrom
copilot/fix-finder-add-xml-documentation

Conversation

Copilot AI commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

The hand-written .NET-friendly overload DatePickerDialog.UpdateDate(DateTime) was missing XML doc comments despite being a public API. This adds <summary>, <remarks>, and <param> to document the method's behavior and its 1-based→0-based month conversion.

/// <summary>
/// Sets the current date shown by the dialog using a <see cref="System.DateTime" />.
/// </summary>
/// <remarks>
/// This is a .NET-friendly overload that forwards to
/// <see cref="UpdateDate(int, int, int)" />, converting the 1-based
/// <see cref="System.DateTime.Month" /> to Android's 0-based month value.
/// </remarks>
/// <param name="date">The date to display in the dialog.</param>
public void UpdateDate (DateTime date)
{
    UpdateDate (date.Year, date.Month - 1, date.Day);
}

Documentation-only change; no behavior modifications.

Co-authored-by: jonathanpeppers <840039+jonathanpeppers@users.noreply.github.com>
Copilot AI changed the title [WIP] Add XML documentation to DatePickerDialog.UpdateDate method Add XML documentation to DatePickerDialog.UpdateDate(DateTime) Jul 16, 2026
Copilot AI requested a review from jonathanpeppers July 16, 2026 02:49
@jonathanpeppers
jonathanpeppers marked this pull request as ready for review July 16, 2026 13:00
Copilot AI review requested due to automatic review settings July 16, 2026 13:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds missing XML documentation to the public, hand-written .NET-friendly overload Android.App.DatePickerDialog.UpdateDate(DateTime), clarifying its forwarding behavior and the 1-based (DateTime.Month) to 0-based (Android) month conversion. This improves API documentation completeness without changing runtime behavior.

Changes:

  • Added <summary>, <remarks>, and <param> XML docs for DatePickerDialog.UpdateDate(DateTime).
  • Documented the month conversion behavior when forwarding to UpdateDate(int, int, int).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[fix-finder] Add XML documentation to DatePickerDialog.UpdateDate(DateTime)

4 participants