Document with precise accuracy

Maintain precise and accurate documentation through both JSDoc annotations and explanatory comments. Ensure all technical documentation matches the actual implementation, avoiding inconsistencies between code and documentation.

Key practices:

1. Keep JSDoc parameter and return types strictly accurate
2. Avoid default values in JSDoc to prevent inconsistencies
3. Document unusual patterns or complex implementations
4. Include clear examples for non-obvious functionality

Example: ```javascript /**

• Format help text for printing.
• @param {string} longOption - long option name e.g. ‘foo’
• @param {object} optionConfig - option config from parseArgs({ options })
• @returns {string} formatted help text for printing
• @example
• formatHelpTextForPrint(‘foo’, { type: ‘string’, help: ‘help text’ })
• // returns ‘–foo help text' */ function formatHelpTextForPrint(longOption, optionConfig) { // Implementation using unusual pattern - explain why if (isSpecialCase(optionConfig)) { // Document why this special case exists // and how it affects the output } // ... rest of implementation }