Conversation
There was a problem hiding this comment.
Pull request overview
Updates the repository’s README.md to better support developer/contributor onboarding for the origin-docs GitBook-backed documentation site.
Changes:
- Rewrites the intro to clarify platform context and provide perspective-based navigation links.
- Adds contributor-focused onboarding: prerequisites, clone steps, manual verification checklist, and repo structure.
- Adds contributor “key rules” plus a “Going deeper” table of internal/external references.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| There is no automated test suite. Quality checks are manual: | ||
|
|
||
| 1. Confirm all internal Markdown links resolve to real files (`grep -r '\]\(\./' .` is a quick scan). |
| │ README.md # vLEI overview and index | ||
| │ why.md # Problems solved by vLEIs | ||
| │ types.md # LE, OOR, ECR, and QVI vLEI types | ||
| │ journey.md # Step-by-step path to vLEI issuance | ||
| │ uses.md # Ways to use vLEIs |
|
|
||
| Origin is operated commercially by [Provenant](https://provenant.net)™ and its partners. However, it is built atop [open source technologies](https://github.com/WebOfTrust), can be extended via that open source, and supports low-friction interactions with participants in the ecosystem who don't use Origin.  | ||
| - If you belong to an org that needs to consume Origin features, see [Clients](perspectives/clients.md). | ||
| - If you belong to an org that uses Origin to deliver value-added identity features to others, see [Service Providers](perspectives/sps/). |
- Fix `perspectives/sps/` link to point to `perspectives/sps/README.md` for consistency with the Going deeper table and to avoid GitHub rendering a raw directory listing instead of the page content. - Broaden the link-verification grep from `\]\(\./'` (only catches `./`-prefixed links) to `grep -rP '\]\((?!https?://)'` so it catches all non-HTTP internal Markdown links, including `perspectives/...` and `concepts/...` style paths used throughout this repo. - Add missing `├──`/`└──` tree connectors to the `vleis/` subtree in the repo structure diagram, making it consistent with all other directory entries in the same block. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copilot review fixes appliedThree issues flagged by Copilot have been addressed in commit 429b9d2:
No escalations — all three items were clear, objective fixes. |
Summary
Test plan
🤖 Generated with Claude Code