docfx icon indicating copy to clipboard operation
docfx copied to clipboard

[Feature Request] More clear error message in case of problem with relative path

Open denisbredikhin opened this issue 4 months ago • 0 comments

Hello,

in one of my md files I had the wrong path to another article (something like "~/docs/frameworks/api/components/httpclient.md"). When I was trying to build my documentation, I was getting exception: System.NotSupportedException: Relative to path has too many '../'. Which didn't tell anything about the file or path that has this problem.

I've built the local version of RelativePath class and changed the following line in the method MakeRelativeTo: throw new NotSupportedException("Relative to path has too many '../'");

to

throw new NotSupportedException($"Relative to path ({relativeTo}) has more '../' than base path {this}.");

Now I can see which path has the problem. Can you please include this small improvement to docfx?

denisbredikhin avatar Oct 15 '24 11:10 denisbredikhin