Use following tags to create robust references using JSDoc.
@category: Specifies the category in which the reference documentation will be placed. You can use/to specify depth (e.g.Repository/Methods).@signature: Describes what type of signature a function or method has. Please write a type declaration in the TypeScript language.@param: Write all parameters.@returns: Specifies what value is returned.@throws: Write documentation for errors that should be noted.@example: Examples are not required, but are recommended as they make the behavior easier to understand.
To automatically generate reference documentations after writing a JSDoc, please run the command below.
# Generate all reference documentations.
just docs-gen reference
# Generate all korean reference docuementations.
just docs-gen reference --lang=ko
# Generate specific reference documentations with glob pattern.
just docs-gen reference --pattern='Tree/Methods/*'
# Translate with OpenAI. Or pass api token with environment variables. (/docs/.env)
just docs-gen reference --translate-ai-token="<OpenAI API Key>"