-
Notifications
You must be signed in to change notification settings - Fork 4.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improvements to documentation comments (that compilers output). #67
Comments
👍 |
Looking at how it works in Sandcastle, I would like to argue against having the Some use cases:
Still, open question for me is, what should happen if there are multiple immediate base types, but no |
This seems like a nice potential enhancement to the expressiveness of the doc facility. |
We are now taking language feature discussion on https://github.com/dotnet/csharplang for C# specific issues, https://github.com/dotnet/vblang for VB-specific features, and https://github.com/dotnet/csharplang for features that affect both languages. |
@gafter: Should we reopen the issue at https://github.com/dotnet/csharplang or do you think it is enough to have the docfx#1306 open? |
I think it would require language (and therefore compiler) support, so if you are still interested an issue at csharplang makes sense. |
@daveaglick : Would love to see that 👍 |
This request is now tracked at dotnet/csharplang#313 |
Hi,
Please add
<inheritdoc />
tag or similar:I think it would be really handy if the compiler(s) when outputting the documentation XML file if it could use inherited documentation where available/requested. Though I am not sure what should be output if there is no documentation available.
Please add the ability to add documentation comments for Namespace/Assembly:
Currently if you want to do this for tools that generate documentation html etc. you have to add a dummy class and add the documentation comments to them. This one is a bit trickier because there aren't any viable options for doing them directly in code. There is nothing you could put the assembly documentation against in code and namespaces are "declared" possibly in multiple files. The only thing I could really think of is a separate XML file that gets merged into the documentation XML file that is output.
Cheers,
dfkeenan
P.S. A Diagnostic and Code Fix that generates document comments for me would also great 😃
The text was updated successfully, but these errors were encountered: