1/// <summary>
2/// This is a single-line summary.
3/// </summary>
4public void SimpleMethod() { }
5
6/// <summary>
7/// This spans multiple lines in the source code
8/// but IntelliSense displays it as ONE line because
9/// XML collapses whitespace and newlines.
10/// </summary>
11public void CollapsedMethod() { }

1/// <summary>
2/// Calculates the total price including tax.
3/// <para>
4/// The tax rate is determined by the customer's shipping address.
5/// International orders use a flat 10% rate.
6/// </para>
7/// <para>
8/// Returns -1 if the cart is empty.
9/// </para>
10/// </summary>
11/// <param name="cartId">The shopping cart identifier.</param>
12/// <returns>Total price with tax, or -1 for empty carts.</returns>
13public decimal CalculateTotal(int cartId) { }

1/// <summary>
2/// Supported formats:<br/>
3/// - JSON<br/>
4/// - XML<br/>
5/// - CSV<br/>
6/// - YAML
7/// </summary>
8public void ParseFile(string path) { }

1/// <summary>
2/// Validates the input data against the following rules:
3/// <list type="bullet">
4/// <item><description>Name must not be empty</description></item>
5/// <item><description>Age must be between 0 and 150</description></item>
6/// <item><description>Email must contain @ symbol</description></item>
7/// </list>
8/// </summary>
9public bool Validate(UserInput input) { }
10
11/// <summary>
12/// Processing steps:
13/// <list type="number">
14/// <item><description>Parse the input file</description></item>
15/// <item><description>Validate all records</description></item>
16/// <item><description>Transform to output format</description></item>
17/// <item><description>Write to destination</description></item>
18/// </list>
19/// </summary>
20public void ProcessFile(string path) { }

1/// <summary>
2/// Sends an email notification to the specified recipient.
3/// </summary>
4/// <remarks>
5/// <para>
6/// This method uses SMTP to send emails. The SMTP server
7/// configuration is read from appsettings.json.
8/// </para>
9/// <para>
10/// Rate limiting applies: maximum 100 emails per minute.
11/// Exceeding this limit throws <see cref="RateLimitException"/>.
12/// </para>
13/// </remarks>
14/// <param name="recipient">Email address of the recipient.</param>
15/// <param name="subject">Email subject line.</param>
16/// <param name="body">HTML body content.</param>
17/// <exception cref="RateLimitException">Thrown when rate limit is exceeded.</exception>
18public void SendEmail(string recipient, string subject, string body) { }

1/// <summary>
2/// Parses a date string in ISO 8601 format.
3/// <para>
4/// Usage:
5/// <code>
6/// var date = ParseDate("2024-01-15");
7/// var dateTime = ParseDate("2024-01-15T10:30:00Z");
8/// </code>
9/// </para>
10/// <para>
11/// Use <c>null</c> to indicate no date filter.
12/// </para>
13/// </summary>
14public DateTime ParseDate(string input) { }

1/// <summary>
2/// Connects to the database and executes a health check.
3/// <para>
4/// This method tests the connection by running a simple
5/// <c>SELECT 1</c> query against the configured database.
6/// </para>
7/// </summary>
8/// <remarks>
9/// <para>
10/// Connection parameters are read from the connection string
11/// named "DefaultConnection" in appsettings.json.
12/// </para>
13/// <para>
14/// Timeout behavior:
15/// </para>
16/// <list type="bullet">
17/// <item><description>Connection timeout: 30 seconds</description></item>
18/// <item><description>Command timeout: 10 seconds</description></item>
19/// <item><description>Retry attempts: 3 with exponential backoff</description></item>
20/// </list>
21/// </remarks>
22/// <returns>
23/// <c>true</c> if the database is reachable; <c>false</c> otherwise.
24/// </returns>
25/// <exception cref="InvalidOperationException">
26/// Thrown when the connection string is not configured.
27/// </exception>
28public bool CheckDatabaseHealth() { }