Question

I created my custom Ajax.ActionLink helper (see below). I also write a summary above my code but it is not showed as it should be.

Here is what I see:

Here is an example of how it should appear:

1st question: As you can see, the summary is not used. Any idea?

2nd question: Usually the summary (when minimized) should appears like this:

But mine appears like this:

Any idea?

    //
    // Summary:
    //     Returns an anchor element that contains the URL to the specified action method;
    //     when the action link is clicked, the action method is invoked asynchronously
    //     by using JavaScript.
    //
    // Parameters:
    //   ajaxHelper:
    //     The AJAX helper.
    //
    //   actionName:
    //     The name of the action method.
    //
    //   routeValues:
    //     An object that contains the parameters for a route. The parameters are retrieved
    //     through reflection by examining the properties of the object. This object
    //     is typically created by using object initializer syntax.
    //
    //   ajaxOptions:
    //     An object that provides options for the asynchronous request.
    //
    //   htmlAttributes:
    //     An object that contains the HTML attributes to set for the element.
    //
    // Returns:
    //     An anchor element.
    public static IHtmlString ActionLink(this AjaxHelper ajaxHelper, string actionName, object routeValues, AjaxOptions ajaxOptions, object htmlAttributes)
    {
        // Allow to have an ActionLink without any text link >> used for buttons with icon only
        return ajaxHelper.ActionLink(
            " ",
            actionName,                
            routeValues,
            ajaxOptions,
            htmlAttributes
        );
    } 

Thanks.

Answer 1

That doesn’t look like a Valid XML Document Comment.

It should be in the Form

/// <summary>
///     Returns an anchor element that contains the URL to the specified action method;
///     when the action link is clicked, the action method is invoked asynchronously
///     by using JavaScript.
/// </summary>
/// <param name="ajaxHelper">The AJAX helper.</param>
/// <returns>An anchor element</returns>