Skip to content

Add namespace-level XML documentation for all Terminal.Gui.Editor namespaces#234

Merged
tig merged 4 commits into
developfrom
tig/add-namespace-documentation
May 24, 2026
Merged

Add namespace-level XML documentation for all Terminal.Gui.Editor namespaces#234
tig merged 4 commits into
developfrom
tig/add-namespace-documentation

Conversation

@tig
Copy link
Copy Markdown
Member

@tig tig commented May 23, 2026

Summary

Adds NamespaceDoc.cs files to each namespace folder so that DocFX generates namespace summaries in the API reference. Documentation content is drawn from README.md descriptions.

Namespaces Documented

Namespace Description
Terminal.Gui.Editor Root namespace with hero.gif image and overview of the Editor view
Terminal.Gui.Editor.Completion Completion provider interface and items
Terminal.Gui.Editor.Document Rope-backed TextDocument, anchors, undo, and document model
Terminal.Gui.Editor.Document.Folding Code-folding infrastructure
Terminal.Gui.Editor.Document.Search Pluggable search strategies
Terminal.Gui.Editor.Document.Utils Shared utility types (rope, deque, compressed tree list)
Terminal.Gui.Editor.Highlighting Syntax highlighting engine
Terminal.Gui.Editor.Highlighting.Xshd xshd format loaders/savers and AST types
Terminal.Gui.Editor.Indentation Pluggable indentation strategies
Terminal.Gui.Editor.Rendering Cell-grid rendering pipeline

Implementation

Each file contains an [CompilerGenerated] internal static class NamespaceDoc with XML <summary> documentation. This is the standard pattern for namespace docs in DocFX/Sandcastle-generated API references.

Closes #230

tig and others added 4 commits May 23, 2026 17:04
…espaces

Add NamespaceDoc.cs files to each namespace folder so that DocFX generates
namespace summaries in the API reference. Documentation content is drawn
from README.md descriptions.

Namespaces documented:
- Terminal.Gui.Editor (root, with hero.gif image)
- Terminal.Gui.Editor.Completion
- Terminal.Gui.Editor.Document
- Terminal.Gui.Editor.Document.Folding
- Terminal.Gui.Editor.Document.Search
- Terminal.Gui.Editor.Document.Utils
- Terminal.Gui.Editor.Highlighting
- Terminal.Gui.Editor.Highlighting.Xshd
- Terminal.Gui.Editor.Indentation
- Terminal.Gui.Editor.Rendering

Closes #230

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@tig tig merged commit c033cb3 into develop May 24, 2026
8 checks passed
@tig tig deleted the tig/add-namespace-documentation branch May 24, 2026 19:17
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.

Add namespace documentation for all Terminal.Gui.Editor namespaces

1 participant