# OpenAPI XmlComments

> Keeps the ASP.NET Core OpenAPI XML-comment generator working when one documentation ID arrives twice.

An MSBuild package for APIs that reference Microsoft.AspNetCore.OpenApi. The XML-comment source generator builds one dictionary from the documentation of every project reference and of the API's own compilation, and de-duplicates neither, so a documented type that arrives from more than one assembly makes /openapi/v1.json answer 500 with "An item with the same key has already been added". This package removes every colliding documentation ID from the referenced XML documentation before compile, and warns (POAX001) about an ID it can only see once the API has been built. The generator stays on, so every XML description stays in the OpenAPI document.

## Documentation version

- Channel: live (default)
- Source: purview-dev/openapi-xmlcomments@main

## Resources

- Repository: https://github.com/purview-dev/openapi-xmlcomments
- Package: https://www.nuget.org/packages/Purview.OpenAPI.XmlComments
- Project page: https://purview.dev/projects/openapi-xmlcomments/
- Documentation: https://purview.dev/docs/openapi-xmlcomments/
- Full machine-readable content: https://purview.dev/projects/openapi-xmlcomments/llms-full.txt

## Documentation pages

- OpenAPI XmlComments: https://purview.dev/docs/openapi-xmlcomments/
- How It Works: https://purview.dev/docs/openapi-xmlcomments/how-it-works/
- Configuration: https://purview.dev/docs/openapi-xmlcomments/configuration/
- Diagnostics: https://purview.dev/docs/openapi-xmlcomments/diagnostics/
- Troubleshooting: https://purview.dev/docs/openapi-xmlcomments/troubleshooting/
- Agent Skills: https://purview.dev/docs/openapi-xmlcomments/agent-skills/
- Testing: https://purview.dev/docs/openapi-xmlcomments/testing/
- Release Flow: https://purview.dev/docs/openapi-xmlcomments/release-flow/
- Contributing: https://purview.dev/docs/openapi-xmlcomments/contributing/