Skip to content

Conversation

@davidejones
Copy link
Member

@davidejones davidejones commented Oct 30, 2025

What does this PR do? What is the motivation?

  • Use a new partial called api/load-specs.html which loads the spec or retrieves already loaded spec from hugo store
  • When reading specs in hugo try to use the yaml file over the deref
  • Delete full_spec_deref.json files
  • Only generate full_spec_deref.json files during the build not committed
  • move spec yaml files to assets dir for possibility of using openapi parsing

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

https://docs-staging.datadoghq.com/david.jones/docseng-135/api/latest/

@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Oct 30, 2025
@davidejones davidejones force-pushed the david.jones/docseng-135 branch from 27b0d5b to 1f76004 Compare October 30, 2025 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants