Skip to content

Conversation

@CyrusNajmabadi
Copy link
Member

@CyrusNajmabadi CyrusNajmabadi commented Mar 27, 2020

Followup to: #42809

Before:

image

After:

image

@CyrusNajmabadi CyrusNajmabadi requested a review from a team as a code owner March 27, 2020 03:20
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just curious, but why do we change DocComments to RegularComments?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just curious, but why do we change DocComments to RegularComments?

Primarily because doc comments are terrible to read in code. They're desigend to be structured, and then rendered nicely by some presenter (i.e. quick-info, or html docs), but they themselves are really unpleasant to look at as the first class source of info.

We convert to just a really simple textual view that puts the content forward and basically hides all the structure tags.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... hides all the structure tags ...

Also loses semantic references and syntax highlighting 😢

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just have to write some tools for that :)

@sharwell
Copy link
Contributor

@CyrusNajmabadi Can you back out #42809 from this change? I prefer to keep the spacing between members under the approach of #42850.

@CyrusNajmabadi
Copy link
Member Author

@sharwell . Yes, that's my plan once your PR goes in.

Copy link

@ghost ghost left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Auto-approval

@ghost ghost merged commit b9b0bc6 into dotnet:master Mar 28, 2020
@CyrusNajmabadi CyrusNajmabadi deleted the decompileSpacing2 branch March 29, 2020 03:50
This pull request was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants