Missing summary info in markdown

[luisxkimo]

Hi,

I'm trying to create md documentation file, but I can't see my summary comment info in the markdown file. Here is an example:

• 0.5.1 version of the tool
• DLL generated by taken from published folder generated by dotnet publish -f netstandard2.1 -o published

[loxsmoke]

Is this the only missing summary?

Check if the compiler-generated XML file is next to the assembly you are documenting.

[luisxkimo]

Hi,

I could review, this is the only info that I miss.

Yes, I'm using a DLL that have in the same directory the XML document generated. Here is the content for this example:

 <member name="M:Loc.Infrastructure.Core.ActiveDirectory.UserPrincipalExtensions.ToActiveDirectoryUser(System.DirectoryServices.AccountManagement.UserPrincipal,System.Collections.Generic.IReadOnlyCollection{System.String})">
    <summary>
    Transforms a <see cref="T:System.DirectoryServices.AccountManagement.UserPrincipal"/> into an <see cref="T:Loc.Infrastructure.Core.ActiveDirectory.Model.ActiveDirectoryUser"/> object;
    </summary>
    <param name="principal">The principal to be transformed.</param>
    <param name="relevantProperties">Additional properties to be included.</param>
    <returns>A new instance of <see cref="T:Loc.Infrastructure.Core.ActiveDirectory.Model.ActiveDirectoryUser"/> with the relevant properties of the principal.</returns>
</member>

[loxsmoke]

Could you paste the full signature of the class and the method?

[luisxkimo]

Sure. Here is the signature:

        /// <summary>
        /// Transforms a <see cref="UserPrincipal"/> into an <see cref="ActiveDirectoryUser"/> object;
        /// </summary>
        /// <param name="principal">The principal to be transformed.</param>
        /// <param name="relevantProperties">Additional properties to be included.</param>
        /// <returns>A new instance of <see cref="ActiveDirectoryUser"/> with the relevant properties of the principal.</returns>
        public static ActiveDirectoryUser ToActiveDirectoryUser(this UserPrincipal principal, IReadOnlyCollection<string> relevantProperties)
        {
           //code
        }

[loxsmoke]

Could not reproduce the problem. Must be something environment-related.

[luisxkimo]

Well, we will try to test in other environments, and let you know if we find some details about our problem.

Regards