PortToDocs adding inheritdoc for types which aren't publicly documented #178

Activity

1. ericstj commented on Sep 25, 2025

   

   ericstj

   on Sep 25, 2025

   MemberAuthor

   More actions

   See
   

   api-docs-sync/src/PortToDocs/src/libraries/ToDocsPorter.cs

   Lines 326 to 332 in 19906e7

   	if (Config.PreserveInheritDocTag)
   	{
   	// Creates the inheritdoc XElement if it does not exist
   	dTypeToUpdate.InheritDocCref = tsTypeToPort.InheritDocCref;
   	// No copying any inherited documentation, the inheritdoc tag takes care of it in MS Docs
   	return;
   	}

   
   

   api-docs-sync/src/PortToDocs/src/libraries/ToDocsPorter.cs

   Lines 386 to 392 in 19906e7

   	if (Config.PreserveInheritDocTag)
   	{
   	// Creates the inheritdoc XElement if it does not exist
   	dMemberToUpdate.InheritDocCref = tsMemberToPort.InheritDocCref;
   	// No copying any inherited documentation, the inheritdoc tag takes care of it in MS Docs
   	return;
   	}

   We shouldn't leave the inheritdoc tag if the target is missing from the DocsCommentsContainer, in that case we should try to copy API from target type in IntelliSenseXmlCommentsContainer.