API Filtering Yml Cannot Include Specific Namespace

[groogiam]

Describe the bug
The api filtering yml mechanism does not allow keeping a specific sub namespace as per https://dotnet.github.io/docfx/docs/dotnet-api-docs.html#filter-by-uid.

To Reproduce
Steps to reproduce the behavior:

The following api rules yml does filters out all items in the MyProject.Server namespace.

apiRules:
- include:
    uidRegex: ^MyProject\.Server\.Config
- exclude:
    uidRegex: ^MyProject\.Server

Expected behavior
Based on the documentation this should generate docs for only MyProject.Server.Config

It seems like the excludes are taking precedence over the includes.

Context (please complete the following information):

• OS: Windows 10 Pro
• Docfx version: 2.73.1+1d7b96c23465e14eafbcb0dd765029a87b5312d4

[groogiam]

Is there any update on this?

[filzrev]

It seems to be resolved by adding type: Type restriction to the exclude rule.

apiRules:
- include:
    uidRegex: ^MyProject\.Server\.Config
- exclude:
    uidRegex: ^MyProject\.Server
    type: Type

Background
Filter rules are evaluated by ConfigFilterRule::CanVisitCore method
Based on the order defined at `filterConfig.yml'.

But It also checking symbol.ContainingSymbol recursively

If MyProject\.Server namespace is excluded by filter config without type restriction.
Then IncludeAttributeDefault method return false for symbol that expected to be included.

I thought it need to fix documentation
or need to change type check logics when type is not specified.

[groogiam]

@filzrev That fixes the issue for me as well. Thank you.