Commit Graph

5 Commits (feat-api-uplift)

Author SHA1 Message Date
Jason Stirnaman 69f72f5342 chore(api-docs): update contributor docs, drop TSM tags, widen TOC, add HEAD badge
- Drop 29 unsupported TSM-era tags from Cloud Serverless via tags.yml drop config
- Add Note callout on Cloud Serverless landing page directing to Cloud (TSM) reference
- Fix Cloud Serverless terminology (databases → buckets, organizations)
- Widen right-side TOC (200px → 260px) for readable operation summaries
- Add HEAD method badge color (#00897B teal)
- Update api-docs/README.md: remove outdated Redoc plugin/decorator docs, add overlay table
- Update .github/instructions: fix Redocly → @redocly/cli
- Rename and slim analyze-api-source agent → analyze-api-specs (remove README duplication)
- Update PLAN.md: clarify @redocly/cli is bundling only, not rendering
2026-03-30 09:17:38 -05:00
Jason Stirnaman b011203e31 refactor(api-docs): remove Redoc UI, update docs for Hugo-native pipeline
Remove dead Redoc HTML generation code (generateRedocHtml, template.hbs,
redoc-static.html gitignore entry) and update all documentation and agent
files to reflect the Hugo-native API rendering pipeline.

Also fix pre-existing YAML frontmatter quoting in agent descriptions and
remove unused eslint-disable directives in ask-ai.ts.
2026-03-16 19:42:17 -05:00
Jason Stirnaman ccd80297bb fix(api-docs): enforce one-tag-per-operation, fix Enterprise v1 spec
- Remove dual tags from v2-compat operations in both v1 specs,
  add x-compatibility-version: v2 for Hugo-native badge rendering
- Fix Enterprise v1 spec version 1.11.6 → 1.12.2 (spec, examples)
- Add GET /shard-status endpoint to Enterprise v1 spec (was only
  in the legacy content page)
- Document one-tag-per-operation convention in api-docs/README.md
- Update api-docs.instructions.md for current file layout and pipeline
- Add analyze-api-source agent for cross-product API docs analysis
2026-03-12 13:04:32 -05:00
Jason Stirnaman 189d86fcda chore(instructions): restructure contributing instructions for humans and assistants 2025-10-08 15:48:44 -05:00
Jason Stirnaman 3e4864a836 Instructions files cleanup:
- Follow Copilot guidelines for naming instructions files according to the directory they apply to
- Copy instructions files as CLAUDE.md to the relevant directory.
- Update placeholder instructions
- Optimize Copilot instructions
- Remove Claude instructions and reference the Copilot instructions file instead

TODO: update the commit hook script to correctly generate and place the files.
2025-09-23 10:37:10 -05:00