45 dépôts
The use of non-executable text within source code for documentation and internal notes.
Distinct from Code Annotations: Candidates focus on AI generation or AST linking, not the basic language feature of writing comments.
Explore 45 awesome GitHub repositories matching programming languages & runtimes · Code Commenting. Refine with filters or upvote what's useful.
This project is a collection of programming language references and syntax cheat sheets designed for rapid developer onboarding. It serves as a library of code-based documentation that uses valid source code files to provide whirlwind tours of various language specifications. The project focuses on programming language learning by providing concise, commented code examples that explain core features and syntax in place. This approach enables developers to quickly grasp language-specific patterns, data types, and execution flow through a consistent reference format. The content covers a broad
Provides inline usage comments and expected outputs directly within source code to explain language features.
Stylus is a CSS preprocessor that transforms a dynamic language into standard CSS. It utilizes a compilation workflow to enable the use of variables, nesting, and arithmetic, which are then rendered into stylesheets for use in frontend asset pipelines. The project is distinguished by a flexible syntax that allows for indentation-based styling, meaning curly braces, colons, and semicolons can be omitted. It further differentiates itself through a JavaScript-driven plugin pipeline and the ability to extend the native syntax with custom JavaScript functions for complex logic. Its capability sur
Supports single-line and multi-line comments for documentation and excluding code from the final CSS output.
ReflectionDocBlock is a PHP docblock parser and doc-comment metadata extractor. It functions as a reflection wrapper that extends the standard PHP Reflection API to convert raw documentation blocks into structured objects. The library provides tools for PHP documentation parsing and reflection tooling. It enables the extraction of structured metadata and annotations from reflection objects or raw doc-comment strings to support automated API documentation and static code analysis.
Converts raw PHP documentation blocks into structured objects for use in automated documentation tools.
TypeDoc is a documentation generator and AST analyzer that transforms TypeScript source code and comments into structured API reference websites or data files. It functions as a static site generator that converts code symbols into a searchable web interface. The project is an extensible framework, allowing users to modify the documentation process and generator logic through a programmable plugin system and custom themes. Its capabilities include API reference generation, source code parsing, and documentation coverage validation to ensure exported members are properly described. It support
Defines how docstrings are interpreted using custom tags, link resolution, and standard documentation formats.
VVDocumenter-Xcode est un outil de flux de travail de documentation IDE et un utilitaire d'automatisation pour l'environnement Xcode. Il sert de générateur de documentation qui crée automatiquement des blocs de commentaires structurés pour le code source Swift en extrayant les paramètres et les valeurs de retour. L'outil fonctionne comme un assistant de commentaire qui réduit la saisie manuelle grâce à l'utilisation d'une séquence de déclenchement personnalisée. Il identifie les signatures de méthodes et les métadonnées pour injecter des en-têtes de documentation standardisés directement dans l'éditeur. Le système couvre l'analyse statique de source et la génération de blocs basée sur des modèles pour assurer un format structurel cohérent. Il inclut des options de configuration pour ajuster les séquences de déclenchement, les styles d'indentation et le format global des blocs de documentation générés.
Automatically creates structured documentation comment blocks by extracting parameters and return values from source code.
This repository is a collection of Python code examples that demonstrate how to use Google Cloud Platform services and APIs. Each sample is organized as a self-contained directory with its own dependencies, making it independently runnable and testable. The samples rely on Google's auto-generated Python client libraries and standardize invocation through command-line argument parsing, with configuration read from environment variables for portability across development and CI environments. The examples cover authentication setup using the gcloud CLI, along with practical demonstrations for se
Embeds usage instructions and expected outputs directly in source code comments for human readers and automated testing.
This project is an interactive programming education resource and tutorial designed for learning the Rust programming language and systems programming concepts. It provides a collection of runnable and editable code examples that serve as a practical reference for language syntax and implementation. The resource features an interactive code sandbox that allows users to execute and test code snippets in real time. It emphasizes the verification of technical accuracy by executing embedded code blocks during the build process to ensure all examples remain functional. The content covers a compre
Covers the use of line and block comments for providing internal documentation within the code.
CodeGeeX2 is a large language model and AI programming assistant designed to generate, translate, and document source code across multiple programming languages. It functions as a multilingual code model that converts natural language prompts into executable code and technical documentation. The project provides a self-hosted AI inference endpoint, allowing the model to be exposed as a web-accessible service. This enables external development tools to integrate automated programming tasks via network calls. Its core capabilities cover multilingual code generation, automated source code docum
Provides automated generation of structured documentation comment blocks from existing source code.
This project is a curated configuration suite and development environment bootstrapper designed to optimize Zsh and Vim. It provides a collection of dotfiles, plugins, and scripts that automate the installation of system packages and shell tools to standardize a local workstation. The suite focuses on creating a consistent experience across the command line and text editor. It implements a Zsh shell framework with syntax highlighting and fuzzy matching, alongside a Vim configuration that includes advanced plugins and modal editing. It also provides a set of sane defaults and Vim-style keybind
Provides shortcuts to quickly toggle comments on single lines or blocks of code.
Rockstar is an esoteric programming language whose syntax is inspired by 1980s hard rock and heavy metal lyrics, making programs read like song lyrics. It uses poetic number literals, where the length of each word in a phrase is parsed as a decimal digit to initialize numeric variables, and pronoun-based variable references, where words like "it" and "they" resolve to the most recently assigned or compared variable at runtime. The language can be compiled to WebAssembly and run inside a web page for in-browser code execution. The language distinguishes itself through a lyric-driven parsing sy
Inserts comments in source code using parentheses, hash symbols, or brackets that are ignored during execution.
This project is a Java persistence generator and database mapping tool designed to produce boilerplate persistence layer code. It translates database schemas and column comments into structured Java annotations and mapping files, replacing the need for manual configuration writing. The tool provides a visual interface for generating code and manages secure database access through SSH tunneling. It allows users to connect to private databases via encrypted tunnels to safely extract schemas without exposing the database to the public internet. The system includes capabilities for database sche
Converts database column comments into code annotations to improve the clarity of field documentation.
Doxygen is a source code documentation generator and multi-language API reference tool. It extracts annotated comments from source code to create structured technical manuals and searchable software libraries in formats including HTML, LaTeX, and PDF. The project functions as a static code analysis visualizer, generating call graphs, class diagrams, and inheritance hierarchies to illustrate codebase structure. It also serves as an XML documentation export engine, producing structured metadata that can be transformed via XSLT or third-party tools. Beyond API extraction, the tool provides a Ma
Provides a utility to insert skeleton comment blocks into source code to standardize technical documentation.
Rushstack est un ensemble d'outils complet pour gérer les monorepos TypeScript à grande échelle, fournissant un framework pour l'automatisation des pipelines de build, la coordination des dépendances et l'analyse statique. Il fonctionne comme un orchestrateur de build incrémental et un système de gestion conçu pour maintenir la cohérence et la performance à travers de multiples packages dans un espace de travail partagé. Le système se distingue par un modèle d'exécution basé sur des graphes acycliques dirigés et un incrémentalisme basé sur le hash de contenu, qui assure que seuls les projets affectés sont reconstruits. Il optimise davantage les workflows de développement via la mise en cache distante des artefacts de build avec des intégrations pour S3, Azure et HTTP, et utilise la gestion d'espace de travail basée sur des liens symboliques pour une visibilité immédiate des changements locaux. L'ensemble d'outils couvre un large éventail de capacités incluant des workflows de release automatisés, l'analyse de contrat API et l'application de la qualité de code en entreprise via des profils de linting standardisés. Il fournit également un support étendu pour le bundling d'actifs, la transpilation TypeScript et la génération de définitions de type à partir de schémas JSON et d'actifs statiques. Des domaines utilitaires supplémentaires incluent la gestion de la localisation, la génération d'avis de licence et l'orchestration d'interfaces de ligne de commande avec une sortie de processus synchronisée.
Checks documentation comments against the TSDoc standard to ensure compatibility with extraction tools.
emmet-vim is a plugin for Vim that functions as a markup automation tool and code expander. It allows for the rapid generation of HTML and CSS structures by expanding shorthand text expressions into full code elements. The tool provides a set of shortcuts for wrapping, balancing, and manipulating tags. It includes a text object extension that enables navigation and editing commands for jumping between nested element boundaries. The project covers a range of capabilities for frontend code refactoring and document hierarchy restructuring. These include tag wrapping, element removal, attribute
Provides keyboard shortcuts to quickly comment or uncomment blocks of markup code.
SWIG is a tool that generates wrapper code to expose C and C++ libraries to a wide range of higher-level programming languages. It reads annotated C/C++ header files and produces language-specific bindings from a single interface definition, supporting languages such as Python, Java, Ruby, C#, Perl, and many others. The generated wrapper code is free from the project's GPL license, allowing users to distribute it under their own terms. The tool handles modern C++ features including templates, namespaces, smart pointers, and constructs up to C++20 through specialized parsing and code generatio
Converts Doxygen-style comments in C++ code into equivalent documentation for generated bindings.
Anthony's ESLint config preset
Triggers micro-codemods like converting arrow functions or sorting objects via special comment markers.
Embeds explanatory comments within code examples to bridge design concepts and implementation.
Ce projet est un plugin de commentaire Vim et un commentateur conscient du langage conçu pour appliquer des caractères de commentaire spécifiques au type de fichier au code source. Il fonctionne comme une extension d'objet texte qui permet de basculer les marqueurs de commentaire sur des lignes ou des blocs de texte sélectionnés. Le plugin utilise les mouvements et plages Vim pour déterminer le texte spécifique à modifier, automatisant le processus d'ajout ou de suppression de marqueurs de commentaire. Il fournit une prise en charge de la syntaxe multi-langage en mappant automatiquement les caractères de commentaire en fonction du type de fichier actuel. Les utilisateurs peuvent définir des caractères de commentaire personnalisés pour des types de fichiers spécifiques afin d'assurer la compatibilité entre différents langages de programmation.
Functions as a language-aware system for toggling comment markers across various programming languages.
Periphery est un outil d'analyse statique et de détection de code mort pour les projets Swift. Il identifie les classes, structs, fonctions et propriétés non référencées, et sert d'optimiseur de surface d'API pour trouver les déclarations publiques qui peuvent être restreintes à un accès interne. L'outil inclut une analyse spécialisée pour les fichiers Interface Builder, tels que les storyboards et les XIB, afin de garantir que les membres connectés à l'UI ne soient pas signalés à tort comme inutilisés. Il fournit également une suppression automatique de code pour éliminer directement des fichiers source le code mort identifié et les paramètres inutilisés. Ses capacités d'analyse couvrent la détection de protocoles redondants, de cas d'enum inutilisés, d'imports inutiles et de propriétés assignées mais jamais lues. Le système gère la dette technique via un filtrage par comparaison de base de référence et prend en charge les projets mixtes en préservant les symboles exposés au runtime Objective-C. Periphery s'intègre aux systèmes de build et aux pipelines CI via une configuration basée sur YAML et peut exporter les résultats d'analyse dans plusieurs formats standards de l'industrie.
Supports inline source code annotations to manually instruct the analyzer to ignore specific symbols or files.
The C/C++ extension for Visual Studio Code provides language support for C and C++ programming, including IntelliSense-powered code editing, navigation, and debugging capabilities. It enables syntax highlighting, code completion, hover information, and error checking for C and C++ source files, along with features like semantic colorization, symbol search, and call hierarchy exploration. The extension offers comprehensive debugging support for C/C++ programs, including launching debug sessions with breakpoints, stepping through code, and inspecting variables. It supports debugging multi-threa
Creates a structured documentation comment block when typing / and pressing Enter.