documentation-standards-language-parity

Enforce documentation standards and language parity across Rust, Python, TypeScript, Ruby, Java, Go, and C#.

836|66|Updated Feb 3, 2025
One-click install
npx skills add https://github.com/kreuzberg-dev/html-to-markdown --skill documentation-standards-language-parity-kreuzberg-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-standards-language-parity
Source: https://github.com/kreuzberg-dev/html-to-markdown/tree/main/.codex/skills/documentation-standards-language-parity
Command: npx skills add https://github.com/kreuzberg-dev/html-to-markdown --skill documentation-standards-language-parity-kreuzberg-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the critical need for consistent, high-quality documentation and code examples across all supported programming languages, ensuring parity and accuracy.

Core Features & Use Cases

  • Mandatory Language Parity: Enforces documentation and code snippets for all 7 supported languages (Rust, Python, TypeScript, Ruby, Java, Go, C#).
  • Standardized Snippet Structure: Defines a clear directory structure and naming convention for code snippets.
  • Language-Specific Documentation Standards: Outlines specific inline documentation requirements for each language (e.g., Rust doctests, Python Google style, Java Javadoc).
  • Polyglot API Documentation: Requires comprehensive documentation for all public APIs, including summaries, detailed descriptions, parameters, return values, examples, related APIs, and error cases.
  • Use Case: When developing a new feature, this Skill ensures that the documentation and examples for that feature are immediately available and accurate in Rust, Python, TypeScript, Ruby, Java, Go, and C#, preventing documentation debt.

Quick Start

Ensure all public APIs have documentation and code examples in Rust, Python, TypeScript, Ruby, Java, Go, and C#.

Frequently Asked Questions about documentation-standards-language-parity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain consistent API documentation across multiple programming languages?

To enforce language parity for documentation, mandate comprehensive API docs and code snippets across Rust, Python, TypeScript, Ruby, Java, Go, and C#. This prevents documentation debt by requiring standardized snippet structures and language-specific inline conventions like Rust doctests or Python Google style.

What are the inline documentation standards for different programming languages?

Language-specific inline documentation standards require Rust doctests, Python Google style, and Java Javadoc. Enforcing these specific documentation tools and build verification processes for each language ensures accurate inline documentation across the entire software development project.

How do I structure code snippets for polyglot software libraries?

To structure code snippets for polyglot libraries, enforce a standardized directory structure and naming convention. This ensures language parity by keeping code examples organized and immediately available across all seven supported programming languages when developing new features.

Does this documentation standard support all major enterprise programming languages?

Yes, this documentation standard supports Rust, Python, TypeScript, Ruby, Java, Go, and C#. It enforces mandatory language parity by requiring comprehensive documentation and code snippets for all public APIs across these seven specific programming environments.

What is the best way to prevent documentation debt in polyglot codebases?

The best way to prevent documentation debt in polyglot codebases is to mandate language parity, requiring documentation and examples for any new feature to be immediately available and accurate across all supported languages before integration, ensuring no language falls behind.