Skip to content

docs: add API reference with full type and method documentation#30

Merged
AWaterColorPen merged 1 commit intomainfrom
feature/phase2-api-reference
Apr 22, 2026
Merged

docs: add API reference with full type and method documentation#30
AWaterColorPen merged 1 commit intomainfrom
feature/phase2-api-reference

Conversation

@AWaterColorPen
Copy link
Copy Markdown
Owner

Summary

Phase 2 second task: API Reference — comprehensive documentation for every public type and method.

Changes

  • New docs/api-reference.md — 700+ line API reference covering:
    • All core types: User, Domain, Role, Object, ObjectData, Policy, UserRolePair, Directory, DirectoryRequest, DirectoryResponse
    • All constants: Read, Write, Manage actions; ObjectTypeRole; DirectorySearchAll/Top
    • All four service interfaces (IBaseService, IFeatureService, IDirectoryService, ICurrentService) with parameters, return values, permission requirements, and usage notes for each method
    • Constructor New and Options fields with defaults
    • Utility functions Check, Filter, ID, IDMap with examples
    • Error reference table
  • Updated README.md — docs table now links to api-reference.md instead of the empty api.md

Part of

Phase 2 documentation buildout (2026-03-10 modernization plan).

Phase 2 task: API documentation covering:
- All core types (User, Domain, Role, Object, ObjectData, Policy,
  UserRolePair, Directory, DirectoryRequest, DirectoryResponse)
- All four service interfaces (IBaseService, IFeatureService,
  IDirectoryService, ICurrentService) with parameters, return values,
  and usage notes for each method
- Constructor (New) and Options fields
- Utility functions (Check, Filter, ID, IDMap)
- Error reference table
- Update README docs table to link to api-reference.md
@AWaterColorPen AWaterColorPen merged commit c961430 into main Apr 22, 2026
1 check passed
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.

1 participant