docs: quality triage — broken links, orphaned pages, content fixes (Phase 1 of #8) - #7
Open
ajile-in wants to merge 2 commits into
Open
docs: quality triage — broken links, orphaned pages, content fixes (Phase 1 of #8)#7ajile-in wants to merge 2 commits into
ajile-in wants to merge 2 commits into
Conversation
- Add orphaned OID4VC Issuer, OID4VP Verifier and Ecosystem pages to SUMMARY nav - Replace dead app.gitbook.com revision URLs with relative links - Fix stale anchors (credebl-saas, Keycloak #top) and a GitBook revision link - Point NextAuth.js reference to the real site - Retarget Getting Started Platform card to the local setup guide - Download SendGrid screenshots from expiring Google Docs CDN into assets Signed-off-by: Ajay Jadhav <ajay@ayanworks.com>
- Correct backwards version comparisons in both Studio guides (older = pre-v2.1.0) - Make cliConfig.json sample valid JSON (strip comments, fix double comma, add missing fileServerToken value and polygon-mainnet comma); fix 'label' field name - Fix garbled consent-notice sentence and prune stale TOC entries (3.3/4) in Ecosystem doc - Split merged Privacy/Integrity bullet in Features; correct stakeholders heading - Rewrite mangled Copyright & License markdown; misc typos (Keycloak, PostgreSQL, phishing-resistant, Endorser, noticeUrl override) - Complete truncated 'Access the CREDEBL API' step with the gateway URL - Repoint OID4VC cross-references from removed per-file docs to in-page sections Signed-off-by: Ajay Jadhav <ajay@ayanworks.com>
ajile-in
force-pushed
the
docs/quality-triage
branch
from
August 21, 2026 19:07
86b8a8b to
a56f547
Compare
ajile-in
changed the title
20 tasks
ajile-in
changed the title
This was referenced Aug 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 1 fixes every critical/high issue found in the docs audit: orphaned pages, broken links, expiring assets, invalid samples and content errors.
Commits
1. Navigation, links & assets (
f2c3f76)llms.txtagent indexapp.gitbook.com/~/revisions/...prerequisite links with relative links into the Service setup guideimplementations.md#credebl-saas→#sovio.id;service-setup.md#top→#keycloak(×3)http://nextauth.js(nonexistent) to next-auth.js.org.gitbook/assets/sendgrid/2. Content correctness (
86b8a8b)cliConfig.jsonsample is now valid JSON: inline comments removed,"postgres",,fixed,fileServerTokenplaceholder added, polygon-mainnet snippet comma added; documented field name corrected tolabel✅ Verification
cliConfig.jsonpassesjq.mdlinks resolve📝 Notes for reviewers
GET /v1/ecosystem/invitations?orgId={ecosystemId}param-name vs description mismatch — tracked as an open question in Docs improvement initiative: roadmap (Phases 1–4) #8, needs platform-team confirmation.(#)links for Consent Service / X509 guides in OID4VC Issuer API — candidates for Phase 4 follow-up once those guides exist.