API Reference
This section contains auto-generated API documentation from XML doc comments in the source code.
Coverage Status
Current XML doc comment coverage is approximately 33%. Areas with gaps will show minimal documentation.
| Project | Coverage | Notes |
|---|---|---|
| DBTools.Core | ~22% | Needs improvement |
| DBTools.App | ~37% | Moderate |
| DBTools.Themes | ~1% | Critical gap |
| SGT | ~50% | Best documented |
| GM | ~23% | Large codebase |
Improving Coverage
To improve API documentation:
- Add
///XML doc comments to public members - Include at minimum:
<summary>,<param>,<returns> - Run
docfx buildto regenerate
Example:
/// <summary>
/// Executes a transaction with the specified action.
/// </summary>
/// <param name="action">The action to execute within the transaction.</param>
/// <returns>True if the transaction succeeded; otherwise, false.</returns>
/// <exception cref="InvalidOperationException">Thrown when no document is active.</exception>
public bool Execute(Action action)
{
// ...
}
Namespaces
Once API metadata is generated via docfx metadata, namespace links will appear here:
- DBTools.Core
- DBTools.App
- DBTools.Themes
- DBTools.GM
- DBTools.SGT
Note: Run
docfx docfx.json(notdocfx-conceptual.json) to generate API documentation from XML comments.