Hmbown
35bca1fd71
The guide topic flips hasPage true and gains a real page instead of linking out to the repository; vocabulary is a new core-concepts topic. Both are registered in docs-map.ts and app/sitemap.ts, so the docs index, navigation, and sitemap stay in agreement. /docs/guide renders the shared four-step path and the pending real-session media slot. /docs/vocabulary renders the execution nouns, modes and permission postures, route-identity provenance fields, the Consultant advisory role, and the measurement principles — including the explicit statement that this site publishes no benchmark leaderboard. docs/fleet now reads its vocabulary from the shared module rather than an inline copy, so the definitions cannot drift between pages. Tests: docs-ia.test.ts covers information architecture; docs-navigation.test.ts is updated for guide's new local-page routing. Harvested from the #3413 web-maturity lane.
48 lines
2.2 KiB
TypeScript
48 lines
2.2 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
import { DOC_TOPICS, docTopicHref, docTopicIsExternal } from "./docs-map";
|
|
import { docsTopicIsCurrent } from "./docs-navigation";
|
|
|
|
function topic(id: string) {
|
|
const value = DOC_TOPICS.find((candidate) => candidate.id === id);
|
|
if (!value) throw new Error(`missing test topic: ${id}`);
|
|
return value;
|
|
}
|
|
|
|
describe("docsTopicIsCurrent", () => {
|
|
it("marks a dedicated docs page current in either website locale", () => {
|
|
expect(docsTopicIsCurrent(topic("modes"), "en", "/en/docs/modes")).toBe(true);
|
|
expect(docsTopicIsCurrent(topic("tools"), "zh", "/zh/docs/tools/")).toBe(true);
|
|
});
|
|
|
|
it("does not mark a different page or the docs hub current", () => {
|
|
expect(docsTopicIsCurrent(topic("modes"), "en", "/en/docs/tools")).toBe(false);
|
|
expect(docsTopicIsCurrent(topic("modes"), "en", "/en/docs")).toBe(false);
|
|
});
|
|
|
|
it("routes install and providers to their existing first-party pages", () => {
|
|
expect(docTopicHref(topic("install"), "en")).toBe("/en/install");
|
|
expect(docTopicHref(topic("providers"), "zh")).toBe("/zh/models");
|
|
expect(docsTopicIsCurrent(topic("install"), "en", "/en/install/")).toBe(true);
|
|
expect(docsTopicIsCurrent(topic("providers"), "zh", "/zh/models")).toBe(true);
|
|
expect(docTopicIsExternal(topic("install"))).toBe(false);
|
|
expect(docTopicIsExternal(topic("providers"))).toBe(false);
|
|
});
|
|
|
|
it("routes the guide to its dedicated docs page in either locale", () => {
|
|
expect(docTopicHref(topic("guide"), "en")).toBe("/en/docs/guide");
|
|
expect(docsTopicIsCurrent(topic("guide"), "en", "/en/docs/guide")).toBe(true);
|
|
expect(docsTopicIsCurrent(topic("guide"), "zh", "/zh/docs/guide/")).toBe(true);
|
|
expect(docTopicIsExternal(topic("guide"))).toBe(false);
|
|
});
|
|
|
|
it("never marks source-document links as local pages", () => {
|
|
expect(docsTopicIsCurrent(topic("contribution"), "en", "/en/docs/contribution")).toBe(false);
|
|
});
|
|
|
|
it("routes former link-out topics to their dedicated docs pages", () => {
|
|
expect(docTopicHref(topic("runtime-api"), "en")).toBe("/en/docs/runtime-api");
|
|
expect(docsTopicIsCurrent(topic("runtime-api"), "en", "/en/docs/runtime-api")).toBe(true);
|
|
expect(docTopicIsExternal(topic("runtime-api"))).toBe(false);
|
|
});
|
|
});
|