Doraku / DefaultDocumentation

Create a simple markdown documentation from the Visual Studio xml one.
MIT No Attribution
160 stars 26 forks source link

Rebuild sometimes loses namespace on property #129

Closed rboylesDev closed 2 years ago

rboylesDev commented 2 years ago

I have wired up DefaultDocumentation to build with my solution of multiple projects. It seems to work well, but we have ran into an issue of inconsistent changes around when namespace prefixes are included or not.

Say I have the below as a method.

public System.BinaryData Data { get; set; }

Occasionally, about 1 every 5-6 builds. The markdown that comes out will remove the "System", so it looks like this:

public BinaryData Data { get; set; }

The issue is we have all the markdown checked into a code repo. Because of the issue, depending on when someone commits, they are touching almost every markdown file.

Doraku commented 2 years ago

oh that's really weird, this is not something that should change. It is a public repo I can look into? Does DefaultDocumentation runs on the devs machine or on a build machine?

rboylesDev commented 2 years ago

Unfortunately it is a private repo and work I am doing for a company. The maybe fortunate thing is that beginning around end of Sept, the issue magically stopped occurring. I am not sure why exactly, I am thinking maybe it had to do with updating Visual Studio 2022 to a newer version however.

Doraku commented 2 years ago

well I hope it won't be coming back then ^^" feel free to reopen this issue if you have new occurrence!