typescript-docs

TypeScript Documentation

Generate production-ready TypeScript documentation with layered architecture for multiple audiences. Supports API docs with TypeDoc, ADRs, and framework-specific patterns.

Overview

Use JSDoc annotations for inline documentation, TypeDoc for API reference generation, and ADRs for tracking design choices.

Key capabilities:

• TypeDoc configuration and API documentation generation
• JSDoc patterns for all TypeScript constructs
• ADR creation and maintenance
• Framework-specific patterns (NestJS, React, Express, Angular, Vue)
• ESLint validation rules for documentation quality
• GitHub Actions pipeline setup

When to Use

Use this skill when creating API documentation, architectural decision records, code examples, or framework-specific patterns for NestJS, Express, React, Angular, or Vue.

Quick Reference

Tool	Purpose	Command
TypeDoc	API documentation generation	npx typedoc
Compodoc	Angular documentation	npx compodoc -p tsconfig.json
ESLint JSDoc	Documentation validation	eslint --ext .ts src/

JSDoc Tags

Tag	Use Case
@param	Document parameters
@returns	Document return values
@throws	Document error conditions
@example	Provide code examples
@remarks	Add implementation notes
@see	Cross-reference related items
@deprecated	Mark deprecated APIs

Instructions

1. Configure TypeDoc

npm install --save-dev typedoc typedoc-plugin-markdown

{
  "entryPoints": ["src/index.ts"],
  "out": "docs/api",
  "theme": "markdown",
  "excludePrivate": true,
  "readme": "README.md"
}

2. Add JSDoc Comments

/**
 * Service for managing user authentication
 *
 * @remarks
 * Handles JWT-based authentication with bcrypt password hashing.
 *
 * @example
 * ```typescript
 * const authService = new AuthService(config);
 * const token = await authService.login(email, password);
 * ```
 *
 * @security
 * - Passwords hashed with bcrypt (cost factor 12)
 * - JWT tokens signed with RS256
 */
@Injectable()
export class AuthService {
  /**
   * Authenticates a user and returns access tokens
   * @param credentials - User login credentials
   * @returns Authentication result with tokens
   * @throws {InvalidCredentialsError} If credentials are invalid
   */
  async login(credentials: LoginCredentials): Promise<AuthResult> {
    // Implementation
  }
}