Skip to content

Conversation

VaclavElias
Copy link
Contributor

@VaclavElias VaclavElias commented Jun 10, 2025

This PR adds docfx configuration and template files and a new GitHub Action, which creates docs in GitHub Pages, probably in https://ikpil.github.io/Box2D.NET.

There is also a very basic comment converter, wrapping // and /// comments into xml summary comment.

Currently the comment converter excludes:

  • comments followed by attribute e.g. [MethodImp]
  • comments of type /* */

This PR closes #30

- Created the project file `Box2D.NET.CommentConverter.csproj` targeting .NET 9.0
- Added a new `Program.cs` file that processes C# files in a specified directory.
- Implemented functionality to read files, extract comment lines, and convert single-line comments (//) to XML-style comments (///) wrapped in summary tags.
@VaclavElias VaclavElias changed the title feat: API Docs + CommentConverted feat: API Docs + CommentConverter Jun 10, 2025
@VaclavElias VaclavElias marked this pull request as ready for review June 10, 2025 05:25
@VaclavElias
Copy link
Contributor Author

Hi @ikpil. Feel free to make any updates. This PR should be working at least as demo-ed here https://www.vaclavelias.com/Box2D.NET/

@ikpil ikpil merged commit 486e4f5 into ikpil:main Jun 15, 2025
2 checks passed
@VaclavElias VaclavElias deleted the feat-api-docs branch June 24, 2025 20:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Question: XML Comments
2 participants