You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There are several improvements we need to address to stabilize this tool for usage in all dotnet repos in an automated fashion.
P0
Before tackling anything else, we need to solve the following:
Separate the two directions into two separate processes. This will help ensure we keep concerns separate and simplify maintenance and future improvements.
Add classes that wrap the dotnet-api-docs xml types and members, but only return xml objects. This will simplify working with Roslyn APIs.
ToTripleSlash: move all remarks to their own xml files next to the source code, and point to the file in the triple slash xml <remarks> item.
Convert the dotnet-api-docs markdown to normal xml if possible.
ToTripleSlash: Figure out how to detect examples in remarks efficiently, move them to their own xml files next to the source code, and point to the file in the triple slash <example> item.
Detect multi-platform documents (*.Unix.cs, *.Windows.cs, etc.) and move their documentation to a single xml file next to the source code, then point to that file in all the triple slash xml items.
ToDocs: Port the -or- lines in exceptions correctly, to ensure they have enough endlines so they render correctly in MS Docs.
ToTripleSlash: backport -or- lines in exceptions with <br/> or other features to ensure they get wrapped and save space.
ToTripleSlash: Add the ability to wrap lines to 120 characters (or a custom number), as requested by WinForms.
P2
Save logs to file. There used to be a change that used System.Threading.Channels, but it was causing some messages to get lost, or not print well so it was backed-out. We can reuse its code but fix the issues: Speed up execution by offloading logging #75
Move the code from this tool into a forked arcade repo and adapt the two executables to be consumable by arcade. We already moved this tool to its own repo under dotnet.
The text was updated successfully, but these errors were encountered:
Move the code from this tool into a forked arcade repo and adapt the two executables to be consumable by arcade.
This depends on the outcomes of the next week's meeting with @markwilkie. But if this tool is decided to be a part of Arcade, this will be the next priority because it will lay the foundation for other work.
There are several improvements we need to address to stabilize this tool for usage in all dotnet repos in an automated fashion.
P0
Before tackling anything else, we need to solve the following:
P1
Only tackle this after we fix the P0s:
<remarks>
item.<example>
item.-or-
lines in exceptions correctly, to ensure they have enough endlines so they render correctly in MS Docs.-or-
lines in exceptions with<br/>
or other features to ensure they get wrapped and save space.P2
Move the code from this tool into a forked arcade repo and adapt the two executables to be consumable by arcade.We already moved this tool to its own repo under dotnet.The text was updated successfully, but these errors were encountered: