Skip to content

Conversation

@MelbourneDeveloper
Copy link
Owner

@MelbourneDeveloper MelbourneDeveloper commented Jan 1, 2026

TLDR;

Website + API docs with unified CSS, XML doc examples, CI path filtering

Brief Details

  • Eleventy website with same CSS as main site (no separate DocFX styling)
  • API docs generated from C# XML comments with clickable type links
  • XML doc examples added to SchemaBuilder, SchemaDiff, SyncState, DbConnectionExtensions
  • CI only runs tests when relevant code changes (dorny/paths-filter)

How Do The Tests Prove This Works?

  • npm run build in Website/ succeeds
  • Generated API docs render with site CSS at /apidocs/
  • Type links navigate to correct pages (e.g., SyncError → /apidocs/Sync/SyncError/)
  • CI skips test jobs when only Website files change

🤖 Generated with Claude Code

@MelbourneDeveloper MelbourneDeveloper merged commit 6e7d852 into main Jan 1, 2026
17 checks passed
@MelbourneDeveloper MelbourneDeveloper deleted the website branch January 1, 2026 08:18
MelbourneDeveloper added a commit that referenced this pull request Jan 1, 2026
# TLDR;
Website + API docs with unified CSS, XML doc examples, CI path filtering

# Brief Details
- Eleventy website with same CSS as main site (no separate DocFX
styling)
- API docs generated from C# XML comments with clickable type links
- XML doc examples added to SchemaBuilder, SchemaDiff, SyncState,
DbConnectionExtensions
- CI only runs tests when relevant code changes (dorny/paths-filter)

# How Do The Tests Prove This Works?
- `npm run build` in Website/ succeeds
- Generated API docs render with site CSS at /apidocs/
- Type links navigate to correct pages (e.g., SyncError →
/apidocs/Sync/SyncError/)
- CI skips test jobs when only Website files change
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.

2 participants