Skip to content

Operations API Migration#462

Merged
Ethan-Arrowood merged 3 commits intomajor-version-reorgfrom
migration/operations-api
Mar 27, 2026
Merged

Operations API Migration#462
Ethan-Arrowood merged 3 commits intomajor-version-reorgfrom
migration/operations-api

Conversation

@Ethan-Arrowood
Copy link
Copy Markdown
Member

Operations API Migration

Summary

Migration of Operations API documentation from versioned_docs/ into the new v4 consolidated reference structure.

Files Created

  • reference_versioned_docs/version-v4/operations-api/overview.md
  • reference_versioned_docs/version-v4/operations-api/operations.md
  • migration-context/link-placeholders/operations-api-link-placeholders.md

Files Modified

  • reference_versioned_sidebars/version-v4-sidebars.json — added Operations API category before Legacy

Source Files Used

reference_versioned_docs/version-v4/operations-api/overview.md

  • versioned_docs/version-4.7/developers/operations-api/index.md (primary)

reference_versioned_docs/version-v4/operations-api/operations.md

  • versioned_docs/version-4.7/developers/operations-api/databases-and-tables.md
  • versioned_docs/version-4.7/developers/operations-api/nosql-operations.md
  • versioned_docs/version-4.7/developers/operations-api/bulk-operations.md
  • versioned_docs/version-4.7/developers/operations-api/sql-operations.md
  • versioned_docs/version-4.7/developers/operations-api/users-and-roles.md
  • versioned_docs/version-4.7/developers/operations-api/token-authentication.md
  • versioned_docs/version-4.7/developers/operations-api/components.md
  • versioned_docs/version-4.7/developers/operations-api/clustering.md
  • versioned_docs/version-4.7/developers/operations-api/configuration.md
  • versioned_docs/version-4.7/developers/operations-api/system-operations.md
  • versioned_docs/version-4.7/developers/operations-api/jobs.md
  • versioned_docs/version-4.7/developers/operations-api/logs.md
  • versioned_docs/version-4.7/developers/operations-api/certificate-management.md
  • versioned_docs/version-4.7/developers/operations-api/analytics.md
  • versioned_docs/version-4.7/developers/operations-api/registration.md
  • versioned_docs/version-4.7/developers/operations-api/custom-functions.md (deprecated operations)

Version Annotations Added

High Confidence (Confirmed via release notes)

  • Component operations (add_component, deploy_component, etc.): Added in v4.2.0 (component architecture)
  • Replication/clustering operations (add_node, cluster_status, etc.): Added in v4.4.0 (Plexus native replication)
  • Certificate management operations (add_certificate, etc.): Added in v4.4.0 (dynamic cert management)
  • Analytics operations (get_analytics, list_metrics, etc.): Added in v4.5.0 (resource/storage analytics)
  • Usage licensing operations (install_usage_license, get_usage_licenses): Added in v4.7.0 (new analytics/licensing)

Needs Verification

  • Databases & Tables operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • NoSQL operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • Bulk operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • SQL operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • Users & Roles operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • Token authentication operations: Marked "Added in: v4.1.0 (inferred, needs verification)"
  • search_by_conditions sort with next tie-breaking: marked as needing version verification

Structure Decisions

operations.md is a synthesized reference — it includes a quick-reference table plus abbreviated operation specs (body shape, key parameters) for each operation, with TODO: links pointing to the relevant feature section for full detail. This avoids duplicating content that lives in section-specific pages (e.g., full Users & Roles docs in users-and-roles/operations.md).

The NATS clustering operations (clustering-nats.md) were not included — that content is legacy/deprecated per the replication migration (PR #461 removed all NATS/legacy clustering content). The modern clustering operations from clustering.md are included.

Link Placeholders Created

See migration-context/link-placeholders/operations-api-link-placeholders.md for the complete list.

Summary:

  • 2 placeholders in overview.md (→ configuration, → security/basic-auth, → security/jwt-auth)
  • ~20 placeholders in operations.md (→ database, → rest/querying, → users-and-roles, → security, → components, → replication, → configuration, → logging, → analytics, → legacy/sql)

Conflicts & Questions for Human Review

Content Conflicts

None — reference/ directory was not touched.

Uncertainties

  1. NATS clustering ops omitted: The clustering-nats.md source file exists but was excluded since the replication PR removed NATS content. If the NATS operations still need to be documented (for users on older versions), they should be added to the legacy section.
  2. Version annotations for core operations (insert/update/delete, etc.) are marked "v4.1.0 inferred" — verify these have been available since v4.1 or earlier.
  3. search_by_conditions sort next field: Unsure exactly when multi-level tie-breaking sort was added — needs verification.
  4. Sidebar position: Operations API is inserted before Legacy. Reviewer should confirm this is the correct position (it was placed between Users & Roles/Replication and Legacy based on the implementation plan Phase 1D ordering).

Migration Map Status

Updated status for reference/operations-api/overview.md and reference/operations-api/operations.md to "In Progress"

Checklist for Human Reviewer

  • Verify version annotations marked as "needs verification"
  • Confirm NATS clustering operations are intentionally excluded (legacy)
  • Check that deprecated operations list is complete and accurate
  • Verify sidebar position is correct
  • Ensure link placeholders make sense for the target sections
  • Update migration-map.md status to "Complete" after merge

🤖 Generated with Claude Code

Adds overview and operations reference for the Operations API section
to the v4 consolidated reference structure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions bot temporarily deployed to pr-462 March 25, 2026 21:24 Inactive
@github-actions
Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-462

This preview will update automatically when you push new commits.

Copy link
Copy Markdown
Member

@kriszyp kriszyp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So we will have all the operations APIs in one page? That sounds good to me.

@Ethan-Arrowood
Copy link
Copy Markdown
Member Author

Yep! If a user doesn't find an operation in its relative section, at a minimum they can find the complete list here and then navigate to it.

@github-actions github-actions bot temporarily deployed to pr-462 March 27, 2026 15:38 Inactive
@github-actions
Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-462

This preview will update automatically when you push new commits.

@Ethan-Arrowood Ethan-Arrowood marked this pull request as ready for review March 27, 2026 15:43
@Ethan-Arrowood Ethan-Arrowood requested a review from a team as a code owner March 27, 2026 15:43
@github-actions github-actions bot temporarily deployed to pr-462 March 27, 2026 15:46 Inactive
@github-actions
Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-462

This preview will update automatically when you push new commits.

@Ethan-Arrowood Ethan-Arrowood merged commit 4f7fc1e into major-version-reorg Mar 27, 2026
7 checks passed
@Ethan-Arrowood Ethan-Arrowood deleted the migration/operations-api branch March 27, 2026 15:53
@github-actions
Copy link
Copy Markdown

🧹 Preview Cleanup

The preview deployment for this PR has been removed.

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.

2 participants