* Format validation errors for display * @param {object} result - Result from validateEntry * @returns {string} Formatted error message

* Validate an entry against the schema * @param {object} data - Parsed YAML data * @param {string} filePath - File path for error messages * @retur

* Read all YAML files from a directory * @param {string} dirPath - Directory containing YAML files * @returns {Promise<object[]>} Array of parsed YA

* Generate HTML for a single category * @param {string} categoryName - Category directory name * @returns {Promise<string>} Generated HTML for all e

* Generate HTML for a single entry * @param {object} entry - Parsed YAML data * @returns {string} HTML string for the details element

* Get all YAML files in the data directory * @returns {string[]} Array of file paths

* Get the compiled validation function * @returns {Function} AJV validate function

* Load and parse a YAML file * @param {string} filePath - Path to the YAML file * @returns {object|null} Parsed YAML object or null on error

* Main function to generate the README

* Main validation function

* Read the README template * @returns {string} Template content

* Read and parse a single YAML file * @param {string} filePath - Path to YAML file * @returns {object} Parsed YAML object

* Replace a placeholder in the template * @param {string} template - Template content * @param {string} placeholder - Placeholder name (without brac

* Convert a name to a filename-safe slug * @param {string} name - Entry name * @returns {string} Slugified filename (without extension)

* Validate a single file * @param {string} filePath - Path to the YAML file * @returns {boolean} True if valid, false otherwise

* Write the final README * @param {string} content - Generated README content