From 8446cca1049ff7630bb44a23aba10d2f583463b3 Mon Sep 17 00:00:00 2001 From: Christopher Date: Sun, 29 Mar 2026 20:31:46 +0000 Subject: [PATCH] fix(docs): serve documentation under /docs/ URL prefix Move all doc content into docs/ subdirectory so Starlight generates URLs at /docs/*. Create standalone Astro landing page at / outside of Starlight. Remove Hero.astro conditional wrapper. Co-Authored-By: Claude Opus 4.6 (1M context) --- apps/web/astro.config.mjs | 19 +++++++-------- apps/web/src/components/Hero.astro | 11 --------- apps/web/src/components/Lander.astro | 1 - .../docs/{ => docs}/evaluation/batch-cli.mdx | 0 .../docs/{ => docs}/evaluation/eval-cases.mdx | 0 .../docs/{ => docs}/evaluation/eval-files.mdx | 0 .../docs/{ => docs}/evaluation/examples.mdx | 0 .../docs/{ => docs}/evaluation/rubrics.mdx | 0 .../{ => docs}/evaluation/running-evals.mdx | 0 .../docs/{ => docs}/evaluation/sdk.mdx | 0 .../{ => docs}/evaluators/code-graders.mdx | 0 .../docs/{ => docs}/evaluators/composite.mdx | 0 .../evaluators/custom-assertions.mdx | 0 .../evaluators/custom-evaluators.mdx | 0 .../evaluators/execution-metrics.mdx | 0 .../{ => docs}/evaluators/llm-graders.mdx | 0 .../{ => docs}/evaluators/structured-data.mdx | 0 .../{ => docs}/evaluators/tool-trajectory.mdx | 0 .../getting-started/installation.mdx | 0 .../{ => docs}/getting-started/quickstart.mdx | 0 .../{ => docs}/guides/agent-eval-layers.mdx | 0 .../{ => docs}/guides/agent-skills-evals.mdx | 0 .../guides/autoevals-integration.mdx | 0 .../docs/{ => docs}/guides/eval-authoring.mdx | 0 .../{ => docs}/guides/evaluation-types.mdx | 0 .../{ => docs}/guides/git-cache-workspace.mdx | 0 .../docs/{ => docs}/guides/human-review.mdx | 0 .../guides/skill-improvement-workflow.mdx | 0 .../docs/{ => docs}/guides/workspace-pool.mdx | 0 .../content/docs/{docs.mdx => docs/index.mdx} | 0 .../docs/{ => docs}/integrations/langfuse.mdx | 0 .../docs/{ => docs}/reference/comparison.mdx | 0 .../docs/{ => docs}/targets/coding-agents.mdx | 0 .../docs/{ => docs}/targets/configuration.mdx | 0 .../{ => docs}/targets/custom-providers.mdx | 0 .../docs/{ => docs}/targets/llm-providers.mdx | 0 .../content/docs/{ => docs}/targets/retry.mdx | 0 .../content/docs/{ => docs}/tools/compare.mdx | 0 .../content/docs/{ => docs}/tools/convert.mdx | 0 .../content/docs/{ => docs}/tools/trace.mdx | 0 .../docs/{ => docs}/tools/validate.mdx | 0 apps/web/src/content/docs/index.mdx | 16 ------------- apps/web/src/pages/index.astro | 24 +++++++++++++++++++ 43 files changed, 32 insertions(+), 39 deletions(-) delete mode 100644 apps/web/src/components/Hero.astro rename apps/web/src/content/docs/{ => docs}/evaluation/batch-cli.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/eval-cases.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/eval-files.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/examples.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/rubrics.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/running-evals.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluation/sdk.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/code-graders.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/composite.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/custom-assertions.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/custom-evaluators.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/execution-metrics.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/llm-graders.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/structured-data.mdx (100%) rename apps/web/src/content/docs/{ => docs}/evaluators/tool-trajectory.mdx (100%) rename apps/web/src/content/docs/{ => docs}/getting-started/installation.mdx (100%) rename apps/web/src/content/docs/{ => docs}/getting-started/quickstart.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/agent-eval-layers.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/agent-skills-evals.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/autoevals-integration.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/eval-authoring.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/evaluation-types.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/git-cache-workspace.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/human-review.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/skill-improvement-workflow.mdx (100%) rename apps/web/src/content/docs/{ => docs}/guides/workspace-pool.mdx (100%) rename apps/web/src/content/docs/{docs.mdx => docs/index.mdx} (100%) rename apps/web/src/content/docs/{ => docs}/integrations/langfuse.mdx (100%) rename apps/web/src/content/docs/{ => docs}/reference/comparison.mdx (100%) rename apps/web/src/content/docs/{ => docs}/targets/coding-agents.mdx (100%) rename apps/web/src/content/docs/{ => docs}/targets/configuration.mdx (100%) rename apps/web/src/content/docs/{ => docs}/targets/custom-providers.mdx (100%) rename apps/web/src/content/docs/{ => docs}/targets/llm-providers.mdx (100%) rename apps/web/src/content/docs/{ => docs}/targets/retry.mdx (100%) rename apps/web/src/content/docs/{ => docs}/tools/compare.mdx (100%) rename apps/web/src/content/docs/{ => docs}/tools/convert.mdx (100%) rename apps/web/src/content/docs/{ => docs}/tools/trace.mdx (100%) rename apps/web/src/content/docs/{ => docs}/tools/validate.mdx (100%) delete mode 100644 apps/web/src/content/docs/index.mdx create mode 100644 apps/web/src/pages/index.astro diff --git a/apps/web/astro.config.mjs b/apps/web/astro.config.mjs index 507cc69a5..2c1452e2f 100644 --- a/apps/web/astro.config.mjs +++ b/apps/web/astro.config.mjs @@ -37,22 +37,19 @@ export default defineConfig({ { icon: 'github', label: 'GitHub', href: 'https://github.com/EntityProcess/agentv' }, ], sidebar: [ - { label: 'Getting Started', autogenerate: { directory: 'getting-started' } }, - { label: 'Evaluation', autogenerate: { directory: 'evaluation' } }, - { label: 'Evaluators', autogenerate: { directory: 'evaluators' } }, - { label: 'Targets', autogenerate: { directory: 'targets' } }, - { label: 'Tools', autogenerate: { directory: 'tools' } }, - { label: 'Guides', autogenerate: { directory: 'guides' } }, - { label: 'Integrations', autogenerate: { directory: 'integrations' } }, - { label: 'Reference', autogenerate: { directory: 'reference' } }, + { label: 'Getting Started', autogenerate: { directory: 'docs/getting-started' } }, + { label: 'Evaluation', autogenerate: { directory: 'docs/evaluation' } }, + { label: 'Evaluators', autogenerate: { directory: 'docs/evaluators' } }, + { label: 'Targets', autogenerate: { directory: 'docs/targets' } }, + { label: 'Tools', autogenerate: { directory: 'docs/tools' } }, + { label: 'Guides', autogenerate: { directory: 'docs/guides' } }, + { label: 'Integrations', autogenerate: { directory: 'docs/integrations' } }, + { label: 'Reference', autogenerate: { directory: 'docs/reference' } }, ], editLink: { baseUrl: 'https://github.com/EntityProcess/agentv/edit/main/apps/web/', }, customCss: ['./src/styles/custom.css'], - components: { - Hero: './src/components/Hero.astro', - }, }), ], }); diff --git a/apps/web/src/components/Hero.astro b/apps/web/src/components/Hero.astro deleted file mode 100644 index f80f85266..000000000 --- a/apps/web/src/components/Hero.astro +++ /dev/null @@ -1,11 +0,0 @@ ---- -import Default from '@astrojs/starlight/components/Hero.astro'; -import Lander from './Lander.astro'; - -const { slug } = Astro.locals.starlightRoute.entry; ---- - -{ slug === "" - ? - : -} diff --git a/apps/web/src/components/Lander.astro b/apps/web/src/components/Lander.astro index e303bd949..549e984a3 100644 --- a/apps/web/src/components/Lander.astro +++ b/apps/web/src/components/Lander.astro @@ -1,5 +1,4 @@ --- -import type { Props } from '@astrojs/starlight/props'; --- diff --git a/apps/web/src/content/docs/evaluation/batch-cli.mdx b/apps/web/src/content/docs/docs/evaluation/batch-cli.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/batch-cli.mdx rename to apps/web/src/content/docs/docs/evaluation/batch-cli.mdx diff --git a/apps/web/src/content/docs/evaluation/eval-cases.mdx b/apps/web/src/content/docs/docs/evaluation/eval-cases.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/eval-cases.mdx rename to apps/web/src/content/docs/docs/evaluation/eval-cases.mdx diff --git a/apps/web/src/content/docs/evaluation/eval-files.mdx b/apps/web/src/content/docs/docs/evaluation/eval-files.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/eval-files.mdx rename to apps/web/src/content/docs/docs/evaluation/eval-files.mdx diff --git a/apps/web/src/content/docs/evaluation/examples.mdx b/apps/web/src/content/docs/docs/evaluation/examples.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/examples.mdx rename to apps/web/src/content/docs/docs/evaluation/examples.mdx diff --git a/apps/web/src/content/docs/evaluation/rubrics.mdx b/apps/web/src/content/docs/docs/evaluation/rubrics.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/rubrics.mdx rename to apps/web/src/content/docs/docs/evaluation/rubrics.mdx diff --git a/apps/web/src/content/docs/evaluation/running-evals.mdx b/apps/web/src/content/docs/docs/evaluation/running-evals.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/running-evals.mdx rename to apps/web/src/content/docs/docs/evaluation/running-evals.mdx diff --git a/apps/web/src/content/docs/evaluation/sdk.mdx b/apps/web/src/content/docs/docs/evaluation/sdk.mdx similarity index 100% rename from apps/web/src/content/docs/evaluation/sdk.mdx rename to apps/web/src/content/docs/docs/evaluation/sdk.mdx diff --git a/apps/web/src/content/docs/evaluators/code-graders.mdx b/apps/web/src/content/docs/docs/evaluators/code-graders.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/code-graders.mdx rename to apps/web/src/content/docs/docs/evaluators/code-graders.mdx diff --git a/apps/web/src/content/docs/evaluators/composite.mdx b/apps/web/src/content/docs/docs/evaluators/composite.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/composite.mdx rename to apps/web/src/content/docs/docs/evaluators/composite.mdx diff --git a/apps/web/src/content/docs/evaluators/custom-assertions.mdx b/apps/web/src/content/docs/docs/evaluators/custom-assertions.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/custom-assertions.mdx rename to apps/web/src/content/docs/docs/evaluators/custom-assertions.mdx diff --git a/apps/web/src/content/docs/evaluators/custom-evaluators.mdx b/apps/web/src/content/docs/docs/evaluators/custom-evaluators.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/custom-evaluators.mdx rename to apps/web/src/content/docs/docs/evaluators/custom-evaluators.mdx diff --git a/apps/web/src/content/docs/evaluators/execution-metrics.mdx b/apps/web/src/content/docs/docs/evaluators/execution-metrics.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/execution-metrics.mdx rename to apps/web/src/content/docs/docs/evaluators/execution-metrics.mdx diff --git a/apps/web/src/content/docs/evaluators/llm-graders.mdx b/apps/web/src/content/docs/docs/evaluators/llm-graders.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/llm-graders.mdx rename to apps/web/src/content/docs/docs/evaluators/llm-graders.mdx diff --git a/apps/web/src/content/docs/evaluators/structured-data.mdx b/apps/web/src/content/docs/docs/evaluators/structured-data.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/structured-data.mdx rename to apps/web/src/content/docs/docs/evaluators/structured-data.mdx diff --git a/apps/web/src/content/docs/evaluators/tool-trajectory.mdx b/apps/web/src/content/docs/docs/evaluators/tool-trajectory.mdx similarity index 100% rename from apps/web/src/content/docs/evaluators/tool-trajectory.mdx rename to apps/web/src/content/docs/docs/evaluators/tool-trajectory.mdx diff --git a/apps/web/src/content/docs/getting-started/installation.mdx b/apps/web/src/content/docs/docs/getting-started/installation.mdx similarity index 100% rename from apps/web/src/content/docs/getting-started/installation.mdx rename to apps/web/src/content/docs/docs/getting-started/installation.mdx diff --git a/apps/web/src/content/docs/getting-started/quickstart.mdx b/apps/web/src/content/docs/docs/getting-started/quickstart.mdx similarity index 100% rename from apps/web/src/content/docs/getting-started/quickstart.mdx rename to apps/web/src/content/docs/docs/getting-started/quickstart.mdx diff --git a/apps/web/src/content/docs/guides/agent-eval-layers.mdx b/apps/web/src/content/docs/docs/guides/agent-eval-layers.mdx similarity index 100% rename from apps/web/src/content/docs/guides/agent-eval-layers.mdx rename to apps/web/src/content/docs/docs/guides/agent-eval-layers.mdx diff --git a/apps/web/src/content/docs/guides/agent-skills-evals.mdx b/apps/web/src/content/docs/docs/guides/agent-skills-evals.mdx similarity index 100% rename from apps/web/src/content/docs/guides/agent-skills-evals.mdx rename to apps/web/src/content/docs/docs/guides/agent-skills-evals.mdx diff --git a/apps/web/src/content/docs/guides/autoevals-integration.mdx b/apps/web/src/content/docs/docs/guides/autoevals-integration.mdx similarity index 100% rename from apps/web/src/content/docs/guides/autoevals-integration.mdx rename to apps/web/src/content/docs/docs/guides/autoevals-integration.mdx diff --git a/apps/web/src/content/docs/guides/eval-authoring.mdx b/apps/web/src/content/docs/docs/guides/eval-authoring.mdx similarity index 100% rename from apps/web/src/content/docs/guides/eval-authoring.mdx rename to apps/web/src/content/docs/docs/guides/eval-authoring.mdx diff --git a/apps/web/src/content/docs/guides/evaluation-types.mdx b/apps/web/src/content/docs/docs/guides/evaluation-types.mdx similarity index 100% rename from apps/web/src/content/docs/guides/evaluation-types.mdx rename to apps/web/src/content/docs/docs/guides/evaluation-types.mdx diff --git a/apps/web/src/content/docs/guides/git-cache-workspace.mdx b/apps/web/src/content/docs/docs/guides/git-cache-workspace.mdx similarity index 100% rename from apps/web/src/content/docs/guides/git-cache-workspace.mdx rename to apps/web/src/content/docs/docs/guides/git-cache-workspace.mdx diff --git a/apps/web/src/content/docs/guides/human-review.mdx b/apps/web/src/content/docs/docs/guides/human-review.mdx similarity index 100% rename from apps/web/src/content/docs/guides/human-review.mdx rename to apps/web/src/content/docs/docs/guides/human-review.mdx diff --git a/apps/web/src/content/docs/guides/skill-improvement-workflow.mdx b/apps/web/src/content/docs/docs/guides/skill-improvement-workflow.mdx similarity index 100% rename from apps/web/src/content/docs/guides/skill-improvement-workflow.mdx rename to apps/web/src/content/docs/docs/guides/skill-improvement-workflow.mdx diff --git a/apps/web/src/content/docs/guides/workspace-pool.mdx b/apps/web/src/content/docs/docs/guides/workspace-pool.mdx similarity index 100% rename from apps/web/src/content/docs/guides/workspace-pool.mdx rename to apps/web/src/content/docs/docs/guides/workspace-pool.mdx diff --git a/apps/web/src/content/docs/docs.mdx b/apps/web/src/content/docs/docs/index.mdx similarity index 100% rename from apps/web/src/content/docs/docs.mdx rename to apps/web/src/content/docs/docs/index.mdx diff --git a/apps/web/src/content/docs/integrations/langfuse.mdx b/apps/web/src/content/docs/docs/integrations/langfuse.mdx similarity index 100% rename from apps/web/src/content/docs/integrations/langfuse.mdx rename to apps/web/src/content/docs/docs/integrations/langfuse.mdx diff --git a/apps/web/src/content/docs/reference/comparison.mdx b/apps/web/src/content/docs/docs/reference/comparison.mdx similarity index 100% rename from apps/web/src/content/docs/reference/comparison.mdx rename to apps/web/src/content/docs/docs/reference/comparison.mdx diff --git a/apps/web/src/content/docs/targets/coding-agents.mdx b/apps/web/src/content/docs/docs/targets/coding-agents.mdx similarity index 100% rename from apps/web/src/content/docs/targets/coding-agents.mdx rename to apps/web/src/content/docs/docs/targets/coding-agents.mdx diff --git a/apps/web/src/content/docs/targets/configuration.mdx b/apps/web/src/content/docs/docs/targets/configuration.mdx similarity index 100% rename from apps/web/src/content/docs/targets/configuration.mdx rename to apps/web/src/content/docs/docs/targets/configuration.mdx diff --git a/apps/web/src/content/docs/targets/custom-providers.mdx b/apps/web/src/content/docs/docs/targets/custom-providers.mdx similarity index 100% rename from apps/web/src/content/docs/targets/custom-providers.mdx rename to apps/web/src/content/docs/docs/targets/custom-providers.mdx diff --git a/apps/web/src/content/docs/targets/llm-providers.mdx b/apps/web/src/content/docs/docs/targets/llm-providers.mdx similarity index 100% rename from apps/web/src/content/docs/targets/llm-providers.mdx rename to apps/web/src/content/docs/docs/targets/llm-providers.mdx diff --git a/apps/web/src/content/docs/targets/retry.mdx b/apps/web/src/content/docs/docs/targets/retry.mdx similarity index 100% rename from apps/web/src/content/docs/targets/retry.mdx rename to apps/web/src/content/docs/docs/targets/retry.mdx diff --git a/apps/web/src/content/docs/tools/compare.mdx b/apps/web/src/content/docs/docs/tools/compare.mdx similarity index 100% rename from apps/web/src/content/docs/tools/compare.mdx rename to apps/web/src/content/docs/docs/tools/compare.mdx diff --git a/apps/web/src/content/docs/tools/convert.mdx b/apps/web/src/content/docs/docs/tools/convert.mdx similarity index 100% rename from apps/web/src/content/docs/tools/convert.mdx rename to apps/web/src/content/docs/docs/tools/convert.mdx diff --git a/apps/web/src/content/docs/tools/trace.mdx b/apps/web/src/content/docs/docs/tools/trace.mdx similarity index 100% rename from apps/web/src/content/docs/tools/trace.mdx rename to apps/web/src/content/docs/docs/tools/trace.mdx diff --git a/apps/web/src/content/docs/tools/validate.mdx b/apps/web/src/content/docs/docs/tools/validate.mdx similarity index 100% rename from apps/web/src/content/docs/tools/validate.mdx rename to apps/web/src/content/docs/docs/tools/validate.mdx diff --git a/apps/web/src/content/docs/index.mdx b/apps/web/src/content/docs/index.mdx deleted file mode 100644 index 79de69d31..000000000 --- a/apps/web/src/content/docs/index.mdx +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Evals that make agents better -description: CLI-first AI agent evaluation framework -hero: - tagline: CLI-first AI agent evaluation. No server. No signup. No overhead. - image: - file: ../../assets/logo.svg - actions: - - text: Get Started - link: /docs/getting-started/introduction/ - icon: right-arrow - - text: GitHub - link: https://github.com/EntityProcess/agentv - variant: minimal - icon: external ---- diff --git a/apps/web/src/pages/index.astro b/apps/web/src/pages/index.astro new file mode 100644 index 000000000..2c89c3ef4 --- /dev/null +++ b/apps/web/src/pages/index.astro @@ -0,0 +1,24 @@ +--- +import Lander from '../components/Lander.astro'; +--- + + + + + + + AgentV - Evals that make agents better + + + + + + + + + +