Chatted with Carlos, and we agreed it probably makes sense to move any long remarks (perhaps those that contain subheadings other than Remarks or Examples) to the conceptual docs. This should be done before any reconciliation work (i.e. dotnet/dotnet-api-docs#10722).
This affects ~620 remarks sections in 172 XML files.
Regex to find remarks with subheadings other than "## R" or "## E":
<remarks>.*\n(((?!</).)*\n)*##\s+[^ER](.*\n)*?.*?</remarks>
Files to exclude:
index.xml,FrameworksIndex/*,Microsoft.VisualBasic*,System.Windows*,System.Management.Instrumentation*,System.Web*
Associated WorkItem - 189686
Chatted with Carlos, and we agreed it probably makes sense to move any long remarks (perhaps those that contain subheadings other than Remarks or Examples) to the conceptual docs. This should be done before any reconciliation work (i.e. dotnet/dotnet-api-docs#10722).
This affects ~620 remarks sections in 172 XML files.
Regex to find remarks with subheadings other than "## R" or "## E":
<remarks>.*\n(((?!</).)*\n)*##\s+[^ER](.*\n)*?.*?</remarks>Files to exclude:
index.xml,FrameworksIndex/*,Microsoft.VisualBasic*,System.Windows*,System.Management.Instrumentation*,System.Web*Associated WorkItem - 189686