Skip to content

Docs site (cache.tharga.net) + PackageIconUrl migration#49

Merged
poxet merged 2 commits into
masterfrom
feature/icon-and-docs
Jun 11, 2026
Merged

Docs site (cache.tharga.net) + PackageIconUrl migration#49
poxet merged 2 commits into
masterfrom
feature/icon-and-docs

Conversation

@poxet

@poxet poxet commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Completes Tharga.Cache's slice of two Toolkit-wide initiatives from 2026-06-01.

1. Migrate PackageIconUrl to thargelion.net/assets

All 6 published packages move from the WordPress-hosted thargelion.se/wp-content/uploads/... path to the clean stable https://thargelion.net/assets/component-cache.png (verified 200 / image/png):
Tharga.Cache, .Redis, .MongoDB, .File, .Blazor, .Mcp.

2. Documentation site at cache.tharga.net

  • DocFX site under docs/ — landing page, 4 articles (getting-started, cache-types, persistence-backends, monitoring), and API reference auto-generated from the core + Redis/MongoDB/File/Mcp libraries.
  • Mirrors Tharga.Test's setup: absolute logo URL + the fixed _master.tmpl overlay, so the navbar logo/favicon render correctly on sub-pages (avoids the DocFX 2.78.x ../https:// trap). Verified locally — sub-page logo src is the clean absolute URL.
  • docs + docs-deploy jobs added to build.yml (gated on needs: release); pages/id-token permissions granted.
  • README links to the docs site; DocFX output gitignored.

Built locally with DocFX 2.78.5 — 0 warnings, 0 errors.

Remaining (manual / external — not code)

  • Configure DNS cache.tharga.net → tharga.github.io and approve the GitHub Pages custom-domain certificate.
  • Cut a patch release so nuget.org picks up the new icon metadata.

- Migrate <PackageIconUrl> on all 6 packages from the WordPress-hosted
  thargelion.se path to https://thargelion.net/assets/component-cache.png
- Add DocFX docs site under docs/ published to cache.tharga.net:
  landing page, 4 articles (getting-started, cache-types,
  persistence-backends, monitoring), and API reference from the core
  + Redis/MongoDB/File/Mcp libraries
- Use the absolute logo URL with the fixed _master.tmpl overlay so the
  navbar logo/favicon render correctly on sub-pages (avoids the
  DocFX 2.78.x ../https:// trap)
- Add docs + docs-deploy jobs to build.yml (gated on needs: release)
  and grant pages/id-token permissions
- Link the docs site from README; gitignore DocFX output
@codecov

codecov Bot commented Jun 11, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@poxet poxet merged commit 5a2bcf9 into master Jun 11, 2026
7 of 8 checks passed
@github-actions

Copy link
Copy Markdown

Released as v0.4.7https://github.com/Tharga/Cache/releases/tag/0.4.7

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