How do I reference method parameters in a method summary when writing XML documentation?

Question

Suppose I have a method as follows:

    /// <summary>
    /// Here I want to reference the parameter <see cref="personId"/>.
    /// </summary>
    /// <param name="personId">
    /// The person id.
    /// </param>
    /// <returns>
    /// The <see cref="Person"/>.
    /// </returns>
    public Person GetPerson(int personId)
    {
        
    }

When I publish my XML documentation using Sandcastle, the cref:

<see cref="personId"/>

gets converted to [!:personId].

The warning in Sandcastle is:

Unknown reference link target

Any advice?

Answer 1

Use <paramref>

<paramref name="personId"/>