Statiq.Docs icon indicating copy to clipboard operation
Statiq.Docs copied to clipboard

Nested types cause URL conflicts for Docs recipe

Open KellyThomas opened this issue 6 years ago • 1 comments

When using the Docs recipe on an code base with nested types there can be name conflicts.

For example when running the recipe against this code:

namespace Demo
{
    public class Temperature
    {
        public enum Mode { Hot, Cold }
    }

    public class Orientation
    {
        public enum Mode { North, South }
    }
}

It produces this error:

Multiple documents output to api/Demo/Mode/index.html (this probably wasn't intended):
  Demo.Orientation.Mode
  Demo.Temperature.Mode

KellyThomas avatar Apr 30 '18 14:04 KellyThomas

I just ran into this issue as well. I would have expected Demo.Temperature.Mode to generate documentation at api/Demo/Temperature/Mode/index.html which would avoid the conflict.

SilentSin avatar Apr 12 '19 10:04 SilentSin