JetBrains Rider - is there an easy way to generate the XML documentation file?

Question

VS has a checkbox that just builds the XML documentation file from C#. I couldn't find anything like this in JetBrains Rider's build settings. What's the easiest way to do this?

Twirl

Answer 1

You have to open Solution Explorer, choose the appropriate project, go to project properties and enable generating for the specific project configuration (or all of them):

Underbrush

Thanks! It wasn't coming up in the other options menu's. – Twirl

Yes, I have noticed =) How you tried to find it? Via search in settings? – Underbrush

Yeah, I had tried searching for a few queries and gave up after 10-15 minutes. Maybe I was searching the wrong terms though. Would be great if it came up in the search box. – Twirl

Answer 2

Rider has public Youtrack (tool to track issues). For the future I recommend to check there before posting here, as usually it has been raised there.

Here is a link to the issue about XML documentation: https://youtrack.jetbrains.com/issue/RIDER-7433?_ga=2.64467503.1034831768.1641148468-999122819.1639050883

Workaround to achieve it is to add to the .csproj file

  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <DocumentationFile>bin\Debug\netcoreapp1.1\PowerBiApiService.xml</DocumentationFile>
  </PropertyGroup>

Mentor

Thanks, I posted a comment there as suggested. That workaround is from 2017, hoping there has been more traction since then. – Twirl

You are right this one is quite out-of-date it seems that this now the up-to-date feature request: youtrack.jetbrains.com/issue/…. But still not implemented as of now – Mentor