Back to all reviewers

Documentation quality standards

vadimdemedes/ink
Based on 2 comments
TypeScript

Ensure documentation follows proper formatting standards and provides complete, practical information for developers. Use JSDoc tags correctly - `@default` should contain actual TypeScript values, not descriptive sentences. When the default value is conditional or complex, use plain text descriptions instead.

Documentation TypeScript

Reviewer Prompt

Ensure documentation follows proper formatting standards and provides complete, practical information for developers. Use JSDoc tags correctly - @default should contain actual TypeScript values, not descriptive sentences. When the default value is conditional or complex, use plain text descriptions instead.

Additionally, include usage examples in API documentation to make it more accessible and helpful. Synchronize examples across different documentation sources (README, inline docs, etc.) to maintain consistency.

Example of incorrect JSDoc usage:

/**
 * Configure whether Ink should only render the last frame of non-static output.
 * @default true if in CI or stdout is not a TTY
 */
patchConsole?: boolean;

Example of correct approach:

/**
 * Configure whether Ink should only render the last frame of non-static output.
 * Default: true if in CI or stdout is not a TTY
 */
patchConsole?: boolean;

For API documentation, include practical usage examples:

/**
 * Hook that calls inputHandler callback with input that program received.
 * Additionally contains helpful metadata for detecting when arrow keys were pressed.
 * 
 * @example
 * ```typescript
 * useInput((input, key) => {
 *   if (key.leftArrow) {
 *     // Handle left arrow key
 *   }
 * });
 * ```
 */
2
Comments Analyzed
TypeScript
Primary Language
Documentation
Category

Source Discussions