Configuration Section Migration

[Ethan-Arrowood]

Configuration Migration

Summary

Migration of the Configuration section from versioned_docs/version-4.7/ into the new reference_versioned_docs/version-v4/configuration/ structure.

Files Created

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

Source Files Used

configuration/overview.md

• versioned_docs/version-4.7/deployments/configuration.md (primary — config file intro, env var mechanisms, HDB_CONFIG)
• release_notes/4.7.2.md (confirmed HARPER_DEFAULT_CONFIG and HARPER_SET_CONFIG introduction)

configuration/options.md

• versioned_docs/version-4.7/deployments/configuration.md (primary — comprehensive options reference, ~1500 lines)
• release_notes/4.2.0.md (http section, componentRoot restructuring)
• release_notes/4.3.0.md (compression default, compaction)
• release_notes/4.4.0.md (native replication/Plexus, sharding)
• release_notes/4.5.0.md (HTTP/2, blob storage, replication port change)
• release_notes/4.6.0.md (per-component logging)
• release_notes/4.7.2.md (HARPER_DEFAULT_CONFIG, HARPER_SET_CONFIG)

configuration/operations.md

• versioned_docs/version-4.7/developers/operations-api/configuration.md (primary — set_configuration and get_configuration operations)

Notes on environment-variables/configuration.md

Per the migration map, the originally planned reference_versioned_docs/version-v4/environment-variables/configuration.md was never created during the environment-variables migration (the migration plan notes explicitly stated its content should be ported into configuration/overview.md). That content — HDB_CONFIG, HARPER_DEFAULT_CONFIG, HARPER_SET_CONFIG, naming conventions, and precedence — is now fully documented in configuration/overview.md. No file needed to be deleted.

Version Annotations Added

High Confidence (Confirmed via release notes)

• HARPER_DEFAULT_CONFIG: Added in v4.7.2
• HARPER_SET_CONFIG: Added in v4.7.2
• HTTP/2: Added in v4.5.0
• Native replication (Plexus): Added in v4.4.0
• Sharding (replication.shard): Added in v4.4.0
• Blob storage paths: Added in v4.5.0
• Per-component logging (logging.external, http.logging, etc.): Added in v4.6.0
• Replication default secure port changed 9925 → 9933: v4.5.0
• Storage compression enabled by default: v4.3.0
• compactOnStart: Added in v4.3.0
• Cookie-based sessions (authentication.enableSessions): Added in v4.2.0

Needs Verification

• componentsRoot rename (from customFunctionsRoot): inferred v4.2.0 — needs human verification
• storage.reclamation section introduction version: inferred v4.5.0 — needs verification
• certificateVerification for HTTP mTLS: inferred v4.7.0 — needs verification
• NATS clustering "Deprecated in: v4.4.0" label — confirm exact deprecation language/policy

Link Placeholders Created

See migration-context/link-placeholders/configuration-link-placeholders.md for full list.

Summary:

• 13 placeholders — spread across options.md (11) and operations.md (2)
• Targets: security (mtls, cert-verification, cert-management), http/tls, mqtt/configuration, logging/api, replication (overview, clustering, sharding), database/compaction, studio/overview, components/overview, operations-api/operations

Conflicts & Questions for Human Review

Uncertainties

1. NATS clustering deprecation — The docs present NATS clustering section as deprecated/superseded by native replication (v4.4.0), but don't explicitly say "deprecated". Review whether the "Deprecated in: v4.4.0" label is appropriate.
2. componentsRoot history — Was it previously called customFunctionsRoot? Verify the v4.2.0 rename.
3. storage.reclamation — No release note explicitly introduces this section. Annotated as "inferred v4.5.0".
4. threads (top-level count) — The get_configuration response shows "threads": 11 (flat integer) while the options docs show threads.count. Human should verify whether the API returns nested or flat.

Migration Map Status

Updated status for Configuration section to "In Progress"

Checklist for Human Reviewer

• Verify NATS clustering deprecation annotation
• Verify componentsRoot rename history (was it customFunctionsRoot in v4.1?)
• Verify storage.reclamation introduction version
• Verify http.mtls.certificateVerification introduction version
• Confirm get_configuration response for threads (nested vs flat)
• Review all version annotations marked "inferred" or "needs verification"
• Ensure link placeholders resolve correctly after target sections are merged
• Update migration-map.md status to "Complete" after merge

[github-actions]

🚀 Preview Deployment

Your preview deployment is ready!

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

This preview will update automatically when you push new commits.

[kriszyp]

Looking good to me.

[github-actions]

🧹 Preview Cleanup

The preview deployment for this PR has been removed.