Docs: GA developer.konghq.com additions and ammendments

[rspurgeon]

Details TBD

• !env YAML tag processing

[github-actions]

🎯 Agentic Issue Triage

Summary: This is a GA-milestone documentation task to add and amend content on [developer.konghq.com]((developer.konghq.com/redacted) for the kongctl 1.0.0 GA release. It currently notes that !env YAML tag processing needs documentation coverage. The body is sparse ("Details TBD"), so fuller scoping is still needed.

Labels applied: documentation (existing), triaged, high-priority (tied to GA Release milestone)

---

📋 Suggested Sub-tasks

• Define the full scope of docs additions/amendments needed for GA
• Document !env YAML tag processing (syntax, supported environments, security considerations, examples)
• Audit existing developer.konghq.com/kongctl pages for accuracy against GA feature set
• Identify any new GA features/commands that lack docs coverage
• Update or create getting-started / quickstart guide for GA
• Add/update declarative config reference docs (aligns with docs/declarative.md)
• Verify all code examples and CLI output snippets are current
• Review and update the troubleshooting page
• Coordinate with DevRel/Docs team for publishing cadence

📝 Notes on `!env` YAML Tag

The !env YAML tag likely allows referencing environment variables in declarative config files — a common pattern for secrets (e.g., API tokens) without hard-coding them. Documentation should cover:

• Syntax: value: !env MY_ENV_VAR
• Which fields support !env substitution
• Behavior when the env var is missing (error vs. empty string)
• Security best practices (don't commit files with sensitive defaults)
• CI/CD usage examples

Look in internal/declarative/loader/ for the current implementation to ensure docs match actual behavior.

🔗 Related Issues & Resources

• Docs: Add and improve documentation for kongctl Audit Logs support #708 — Docs: Add and improve documentation for kongctl Audit Logs support (open, medium-priority)
• Docs: Update developer site Konnect landing page to reference kongctl #550 — Docs: Update developer site Konnect landing page to reference kongctl (open, low-priority)
• Docs: Portal Customization images #38 — Docs: Portal Customization images (open, medium-priority)
• [Current developer docs]((developer.konghq.com/redacted)
• docs/declarative.md in this repo — inline reference doc that may need syncing with external site

💡 Nudges for the Team

• Since this is tied to the GA Release: 1.0.0 milestone, coordinating the docs publication with the release tag is important — consider a docs PR that goes live simultaneously with the release.
• The "Details TBD" body suggests this was filed as a placeholder. @rspurgeon — when you have time, fleshing out the full list of docs changes needed here would help others contribute and avoid duplicate work.
• Consider cross-linking from the GA release notes to the new/updated docs pages.

Generated by Opened Issue Triage for issue #779 · ● 172.8K · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/issue-triage.md@69b5e3ae5fa7f35fa555b0a22aee14c36ab57ebb