{"schemaVersion":1,"title":"Validate documentation content","url":"https://appgram.github.io/docsy/versions/current/es/guides/tutorials/content-validation","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/es/guides/tutorials/content-validation","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/es/guides/tutorials/content-validation.json","version":"current","locale":"es","markdown":"# Validate documentation content\n\nCatch ingestion failures, invalid API examples, broken links, and invalid article components before publishing.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nDocsy validates content before serving a production build, not only TypeScript and YAML shapes.\n\n## Run the checks\n\n```bash\nnpm run validate\nnpm run build\n```\n\nBoth commands load registered articles, expand snippets, render rich components, load SDK inputs, and check configured API sources. They verify every configured version and locale. `build` then creates the production output.\n\n## What fails validation\n\n* Unreadable or malformed configured sources.\n* OpenAPI structural errors and unresolved references, including external reference files.\n* API examples that do not conform to their declared schemas.\n* Unknown, disabled, or malformed article components and invalid snippet includes.\n* Missing internal documentation routes, heading anchors, and referenced local assets.\n* Duplicate article variants or unknown version/locale registrations.\n\nAPI input is checked and bundled with Redocly's OpenAPI engine. Generated request examples use the declared security scheme, inherited parameters, and required query/header inputs rather than assuming Bearer authentication.\n\nSchema validation checks examples supplied in the API specification. When a schema has no explicit example, generated values are illustrative placeholders, not proof of a business-valid request; review them against your API's constraints and integration tests.\n\n## Configure validation\n\n```yaml\nvalidation:\n  links: true\n  api: true\n```\n\nBoth default to true. Disable a check only deliberately: `links: false` skips internal-link validation; `api: false` skips strict API linting, but source loading and reference bundling still fail on errors. An unavailable configured API or SDK source does not silently disappear from the portal.\n\nLinks outside the configured documentation mount and external websites are not fetched. Validation does not run code samples, make live API requests, verify credentials, or guarantee the factual accuracy of prose. Contract/example checks are offline checks of the configured specification. Keep a human review step and your existing integration tests.\n\n## Review before publishing\n\n* Validate the configured sources, internal links, and heading anchors.\n* Build the exact version and language combinations you intend to publish.\n* Review examples and permission rules before deploying.\n\n","contentLocale":"en","isFallback":true,"authorship":{"authors":[{"name":"nedimf","kind":"human","github":"nedimf","avatar":"/docsy/assets/authors/nedimf.png","role":"AppGram","id":"nedimf","url":"https://github.com/nedimf"},{"name":"AppGram","kind":"organization","github":"AppGram","url":"https://appgram.dev","avatar":"/docsy/assets/ag-logo.svg","id":"appgram"}],"contributors":[],"reviewedBy":[]},"editUrl":"https://github.com/AppGram/docsy/edit/main/content/tutorials/content-validation.md"}