docs: make the README, the services overview and the page's own copy match the code - #31
Merged
Merged
Conversation
…match the code An accuracy pass over the final tree of this stack. Every factual claim in README.md was checked against the code and README.ko.md brought into step (same sections, facts and numbers, natural Korean). - `npm run preview` does run the Vite API proxies (preview.proxy defaults to server.proxy) but answers missing files with index.html; the README said the opposite. `npm run serve` is the local check that behaves like the origin: 404s, no directory listing, no proxies. - docs/mossland-services-overview.md presented its cross-service handoff model as operation; it is labelled as the design sketch it is. - The page's search, share and status copy called the belts "real-time"; the data is polled and the belts illustrate workflows. index.html meta, the sidebar status string, the canvas header and og-image (svg + png) now say so, with a test that keeps that copy from overclaiming again. - Comments that described behaviour the code no longer has are fixed, and ecosystem-client.ts notes that its cross-origin reads must stay inside the page CSP's connect-src. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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
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.
Stacked on #30 (← #29 ← #28 ← #27 ← #26) — the last PR of the stack. Merge in order. This PR's diff is only its own commit.
The earlier PRs each updated the README sentences they touched. This one is an accuracy pass over the final tree. Every factual claim in
README.mdwas checked against the code, by running commands where possible: cadences, timeouts, retry schedule, stale threshold, breakpoints, touch and keyboard behaviour, detail-view contents, the proxy table, CI and deploy requirements, and the health JSON.README.ko.mdwas brought into step: same sections on the same lines, the same facts and numbers, in natural Korean.Claims that were wrong
npm run previewdoes run the three Vite API proxies, because Vite'spreview.proxydefaults toserver.proxy. It also answers every missing file,/assets/*.jsincluded, withindex.htmland a 200. The README said preview had no proxies.npm run serveis the local check that behaves like the origin: 404s, no directory listing, no proxies. Both READMEs and the nginx example's header now say this, checked live on Vite 7.3.6.docs/mossland-services-overview.mdpresented the cross-service handoff model as how the services operate. It now opens with a status note and marks the conceptual sections as a design sketch; today each service runs its own collectors, and no data handoff between services exists. Algora is listed as archived, matching the live registry. The structure of the doc is unchanged.LIVE — Real-time service data, the canvas header ("live belts for the services that stream"), and the preview image ("visualized in real time"). The data is polled and the belts illustrate workflows. All of it now says what is true.og-image.pngwas re-rendered from the updated SVG at 1200×630, with the same font and layout.tests/page-copy.test.tskeeps this copy from overclaiming again.Connecting...Comments
ecosystem-client.tsnow says its registry, aggregate andstatusUrlreads need no proxy entry but must stay inside the page CSP'sconnect-src, with what a blocked read does to each. This was handed on from ci: test main after merge, and harden how a build is served #26.What is verified, and what is not
npm run previewandnpm run servebehaviour checked by curl on a real build#deploy/#배포)./api/health, one-command rollback). It cannot be verified without touching production.🤖 Generated with Claude Code