Command Documentation Updates Summary
Overview
This document summarizes the updates made to the README.md documentation for HANA CLI commands to reflect the consistency improvements implemented in the codebase.
Changes Made
Commands with Updated CURRENT_SCHEMA Defaults
The following commands now document the default value of **CURRENT_SCHEMA** for their schema parameters:
- export - Schema parameter default updated
- import - NEW schema parameter added with
**CURRENT_SCHEMA**default - dataProfile - Schema parameter default updated
- dataDiff - Both schema1 and schema2 parameters updated with
**CURRENT_SCHEMA**defaults - dataValidator - Schema parameter default updated
- duplicateDetection - Schema parameter default updated
- dataLineage - Schema parameter default updated
- erdDiagram - Schema parameter default updated
Commands with New Profile Parameter Documentation
The following commands now document the new --profile parameter (CDS Profile support):
List/Query Commands:
- tables
- views
- indexes
- procedures
- functions
- sequences
- triggers
- objects
- columnStats
- spatialData
- partitions
- callProcedure
- tableGroups
- ftIndexes
- graphWorkspaces
- libraries
- roles
Commands with Both Updates
- export - Schema default + profile parameter
- import - Schema parameter (new) + profile parameter (existing)
- tables - Profile parameter added (schema default already present)
- callProcedure - Profile parameter added (schema default already present)
Implementation Notes
Parameter Formatting
All profile parameters follow the standard pattern in the README:
--profile, --Profile CDS Profile [string]Where -p short form conflicts with existing parameters (like -p for port in cds command or -p for procedure names in procedures command), the parameter is documented without a short form.
Schema Parameter Default Format
The default **CURRENT_SCHEMA** is consistently documented as:
[string] [default: "**CURRENT_SCHEMA**"]Alignment with Code Changes
These README updates align with the code modifications made to 30 command files:
- 10 files received CURRENT_SCHEMA defaults for schema parameters
- 19 files received new profile parameters with
['p']alias - 1 file (import.js) received both schema parameter addition AND profile parameter support
Affected Files
The following command implementations have corresponding README updates:
bin/export.js- Schema + Profilebin/import.js- Schema + Profilebin/dataProfile.js- Schema defaultbin/dataLineage.js- Schema defaultbin/dataDiff.js- Schema defaultsbin/dataValidator.js- Schema defaultbin/duplicateDetection.js- Schema defaultbin/erdDiagram.js- Schema defaultbin/tables.js- Profilebin/views.js- Profilebin/indexes.js- Profilebin/procedures.js- Profilebin/functions.js- Profilebin/sequences.js- Profilebin/triggers.js- Profilebin/objects.js- Profilebin/columnStats.js- Profilebin/spatialData.js- Profilebin/partitions.js- Profilebin/callProcedure.js- Profilebin/tableGroups.js- Profilebin/ftIndexes.js- Profilebin/graphWorkspaces.js- Profilebin/libraries.js- Profilebin/roles.js- Profile
Quality Assurance
All command documentation updates in README.md have been verified to:
- Match the actual command code implementations
- Follow consistent formatting conventions
- Include proper parameter descriptions and type information
- Maintain consistency with existing documentation style
- Use proper default value notation where applicable
Related Documentation
For comprehensive details about these changes, see:
- CONSISTENCY_REVIEW_COMPLETE.md - Full analysis and QA notes
- COMMAND_CONSISTENCY_ANALYSIS.md - Detailed audit findings
- COMMAND_CONSISTENCY_FIXES.md - Implementation details