Skip to content

docs: fix outdated development documentation#160

Merged
jjeliga merged 6 commits intomainfrom
docs/fix-outdated-development-docs
Apr 2, 2026
Merged

docs: fix outdated development documentation#160
jjeliga merged 6 commits intomainfrom
docs/fix-outdated-development-docs

Conversation

@jezekra1
Copy link
Copy Markdown
Contributor

@jezekra1 jezekra1 commented Mar 31, 2026

Summary

  • quickstart: Python 3.13 → 3.14 in manual install commands (both Linux/macOS and Windows)
  • cli-reference: remove deleted commands (agent logs, agent env, top-level logs/env), update agent add/update signatures to match current code, add missing admin command and --version flag, fix platform start --set/-f help text, remove platform import --mode
  • deployment-guide: fix Keycloak roles (kagenti-admin/kagenti-developeradk-admin/adk-developer), fix initContainers Helm value path to server.initContainers.createVectorDbExtension, remove phantom adminPassword from auth.basic, add missing external S3 params (port, protocol, bucket, region, existingSecret)
  • deploy-your-agents: fix UI URL to localtest.me:8080
  • platform-api-client: remove phantom Provider Builds API section (6 methods + examples that don't exist in the TypeScript SDK)
  • a2a-client: add warning about state value compatibility between Kagenti SDK (uppercase) and @a2a-js/sdk (lowercase)
  • getting-started: add missing @kagenti/adk/experimental/server SDK entrypoint
  • rag: fix import path from kagenti_adk.util.file to canonical kagenti_adk.platform

Linked issues

Closes #161

Test plan

  • Verify docs build succeeds
  • Spot-check CLI reference against kagenti-adk --help / kagenti-adk agent --help
  • Verify Keycloak roles match provision-job.yaml
  • Confirm external S3 params match values.yaml

@jjeliga jjeliga force-pushed the docs/fix-outdated-development-docs branch 2 times, most recently from 9577ef2 to 8b87d67 Compare April 1, 2026 10:16
@jjeliga jjeliga requested review from jenna-winkler and tomkis April 1, 2026 11:39
jezekra1 and others added 6 commits April 2, 2026 08:29
Update docs/development/ to match current codebase:
- quickstart: Python 3.13 → 3.14 in manual install commands
- cli-reference: remove deleted commands (agent logs, agent env, top-level
  logs/env), update agent add/update signatures, add admin command and
  --version flag, fix platform start --set/-f help text, remove platform
  import --mode
- deployment-guide: fix Keycloak roles (adk-admin/adk-developer), fix
  initContainers Helm value path, remove phantom adminPassword from
  auth.basic, add missing external S3 params
- deploy-your-agents: fix UI URL to localtest.me:8080
- platform-api-client: remove phantom Provider Builds API section
- a2a-client: add warning about state value compatibility
- getting-started: add experimental/server SDK entrypoint
- rag: fix import path to canonical kagenti_adk.platform

Signed-off-by: Radek Ježek <radek.jezek@ibm.com>

Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com>
Signed-off-by: Radek Ježek <radek.jezek@ibm.com>
Signed-off-by: Petr Bulánek <bulanek.petr@gmail.com>
Signed-off-by: Jan Jeliga <jeliga.jan@gmail.com>
Signed-off-by: Jan Jeliga <jeliga.jan@gmail.com>
Signed-off-by: Jan Jeliga <jeliga.jan@gmail.com>
@jjeliga jjeliga force-pushed the docs/fix-outdated-development-docs branch from 3dd3025 to cc1d688 Compare April 2, 2026 09:40
@jjeliga jjeliga merged commit 9fe61e2 into main Apr 2, 2026
19 of 21 checks passed
@jjeliga jjeliga deleted the docs/fix-outdated-development-docs branch April 2, 2026 12:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation has drifted from the codebase

4 participants