Awesome GitHub RepositoriesAPI Documentation Generators

This project is a comprehensive reference collection of practical implementation examples and patterns for building applications with Spring Boot. It serves as a Java web application template and a showcase for developing functional web services featuring REST endpoints, template engines, and global exception handling. The repository distinguishes itself by providing detailed demonstrations of enterprise-grade features, including distributed locking, task scheduling, and asynchronous message exchange using brokers like RabbitMQ. It also includes reference implementations for automated API doc

Beego is a high-performance toolkit for building web applications and RESTful APIs using the Go programming language. It is structured as an MVC web framework that separates data models, views, and controllers to organize application logic. The project provides a comprehensive suite of integrated tools, including an object-relational mapper for translating code objects into database tables and a session manager for maintaining user identity and state across server requests. It also includes an internationalization framework for managing multilingual content and translating text based on user

Gin-vue-admin is a full-stack development scaffold designed to accelerate the creation of enterprise-grade web applications. It provides a pre-configured foundation for both backend and frontend components, incorporating a modular plugin architecture that allows developers to organize and manage application features as decoupled packages. The platform distinguishes itself through extensive automation, utilizing template-driven code generation to produce boilerplate code and interactive API documentation directly from source code annotations. It features a database-first schema mapping system

This project is a comprehensive educational resource and programming course covering C++ language semantics and features from C++03 through C++26. It provides structured tutorials and technical guides focused on modern C++ development. The material offers specialized instruction on template metaprogramming, including the use of type traits and compile-time computations. It features detailed guides on concurrency and parallelism for multi-core execution, as well as a reference for software design applying SOLID principles and RAII. Additionally, it covers build performance optimization to redu

JSDoc is a JavaScript API documentation generator that parses comments in source code to produce structured documentation files for a project interface. It functions as a source code documentation tool that extracts metadata from code comments to automate the creation of technical API references. The system operates as a template-based documentation engine, supporting external templates to customize the visual presentation and layout of the output. It also serves as a Markdown documentation exporter, transforming extracted documentation into Markdown files for use on alternative publishing pl

Swag is a documentation tool for Go that generates standardized API specification files by parsing declarative annotations within source code. It functions by analyzing source files to extract metadata from comments and function signatures, transforming them into machine-readable formats such as JSON or YAML. This process ensures that technical documentation remains synchronized with the underlying code structure throughout the development lifecycle. The tool distinguishes itself through its ability to perform static source code parsing and type-system reflection, which allows it to map compl

apidoc هو مولد وثائق API من كود المصدر يقوم بتحليل التعليقات التوضيحية المتخصصة داخل التعليقات لإنشاء موقع وثائق API قابل للبحث تلقائياً. يعمل كمحلل API يعتمد على التعليقات التوضيحية ومولد مواقع وثائق ثابتة، حيث يستخرج التعريفات مباشرة من كود المصدر للحفاظ على مرجع متزامن. تم تصميم الأداة كمحلل متعدد اللغات، يستخدم تعبيرات نمطية قابلة للتكوين لاستخراج البيانات الوصفية من لغات برمجة مختلفة. يمكنها أيضاً العمل كمصدر لتعريفات JSON API، حيث تحول تعليقات كود المصدر إلى ملفات JSON خام لاستخدامها في مخططات خارجية أو قوالب مخصصة. إلى جانب التوليد الأساسي، يدعم النظام تخطيطات وثائق مخصصة، وفلاتر رؤية للأساليب الخاصة أو المهملة، والقدرة على اختبار نقاط نهاية API مباشرة من الواجهة المولدة. يمكن أتمتة سير العمل من خلال مراقبة ملفات المصدر بحثاً عن تغييرات لتحفيز إعادة التوليد في الوقت الفعلي. يمكن تنفيذ المولد عبر واجهة سطر الأوامر، أو تشغيله برمجياً كمكتبة، أو نشره باستخدام حاوية Docker.

This project is a static archive of documented corporate controversies and alleged unethical actions that have been removed from local internet search results. It functions as a research platform compiling evidence of corporate misconduct for public awareness and accountability purposes, specifically focused on incidents that have been censored from search results. The archive stores each documented incident as a plain Markdown file, enabling easy editing and full version control through Git. All incident pages are pre-rendered as flat HTML files at build time for fast delivery, with a respon

The minimal amount of CSS to replicate the GitHub Markdown style

xmall is a distributed e-commerce platform based on a service-oriented architecture. It separates business logic into independent services that communicate over a network to ensure scalability and fault tolerance, utilizing a decoupled storefront interface for customer transactions. The platform employs a distributed architecture using Dubbo for service orchestration and Zookeeper for cluster coordination and service discovery. It integrates a specialized set of components including an asynchronous message broker for background tasks, an indexed search system for product catalogs, and a centr

Hug is a type-driven Python web framework designed for building APIs. It uses Python type annotations to automatically validate and convert incoming request data and to format outgoing responses. The framework functions as an automated documentation tool by extracting function signatures and markers from source code to generate accessible API specifications. It also supports non-blocking coroutines for asynchronous API processing to handle background tasks without interrupting the main request cycle. The project provides capabilities for REST API development, including route mapping, endpoin

RuoYi-Vue3 is a full-stack administrative dashboard and permission management framework built with SpringBoot and Vue 3. It serves as an enterprise management backend providing a decoupled architecture that separates the API from the user interface. The project features a low-code CRUD generator that automatically produces frontend and backend boilerplate code and API documentation from database tables. It implements a comprehensive role-based access control system for managing users, departments, and granular permissions at the menu and button levels, secured by stateless JSON Web Token auth

Snap.js is a JavaScript library for building draggable side navigation panels on touch devices. It enables slide-in menus from the left or right screen edge, driven by a gesture-based state machine that interprets drag and flick gestures to open and close the panel. The library distinguishes horizontal menu drags from vertical scrolling by analyzing the initial touch movement angle, and locks menu movement to a single axis to prevent interference. It uses hardware-accelerated CSS transforms for smooth animations and provides configurable snap thresholds that determine whether a drag should op

Documentation.js is a multi-purpose documentation tool that parses JSDoc annotations from JavaScript and TypeScript source files to generate formatted API documentation. It functions as both a documentation generator and a JSDoc linter, scanning source code for non-standard or incorrect annotations and returning human-readable warnings to enforce documentation quality. The tool operates through a pipeline-based architecture that parses JSDoc comments into an abstract syntax tree, validates annotations against style and correctness rules, and outputs documentation through interchangeable plugi

This repository is a curated collection of tutorials and source code examples for learning Spring Boot development, covering a range of practical project types. It provides hands-on materials for building complete applications, including a bulletin board forum system, a full-stack blog, and a large-scale e-commerce system, as well as projects that demonstrate a decoupled frontend and backend architecture. The collection focuses on guiding developers through real-world application construction, with step-by-step tutorials and source code studies for each project. It covers fundamental Spring B

ts-migrate هي أداة ترحيل آلية مصممة لتحويل كود مصدر JavaScript إلى ملفات TypeScript قابلة للتجميع. تعمل كإطار عمل لترحيل الكود يستخدم أشجار بناء الجملة المجردة (AST) لإجراء عمليات إعادة هيكلة واسعة النطاق وتغييرات هيكلية عبر المشروع. توفر الأداة إطار عمل قابلاً للتخصيص لتعريف قواعد التحويل القائمة على الإضافات (plugins)، مما يسمح بأتمتة تغييرات برمجية محددة. تتضمن محركات متخصصة لتحويل تعريفات أنواع JSDoc إلى تعليقات توضيحية أصلية في TypeScript، وأداة لقمع أخطاء المترجم عن طريق إدراج تأكيدات النوع أو تعليقات التجاهل. يغطي النظام مجموعة واسعة من قدرات الترحيل، بما في ذلك تحويل أنواع خصائص React وطرق دورة الحياة، وتطبيع تعريفات الفئات، والقدرة على استهداف أدلة محددة بشكل تدريجي من خلال التصفية القائمة على الأنماط.

هذا المشروع عبارة عن إطار عمل شامل للبرمجة الأدبية (literate programming) يتيح للمطورين بناء مكتبات Python جاهزة للإنتاج بالكامل داخل Jupyter Notebooks. من خلال التعامل مع دفاتر الملاحظات كمصدر أساسي للحقيقة، فإنه يدمج الكود والتوثيق والاختبار في خط أنابيب تطوير موحد يتم تصديره مباشرة إلى وحدات Python القياسية. يتميز إطار العمل بأدوات متخصصة مصممة للتغلب على التحديات المتأصلة في استخدام دفاتر الملاحظات في هندسة البرمجيات المهنية. يتضمن خطافات Git مخصصة ومحركات دمج تقوم بتنظيف بيانات تعريف دفتر الملاحظات المتقلبة، مما يلغي بشكل فعال الاختلافات المزعجة ويحل تعارضات الدمج. علاوة على ذلك، يستخدم توجيهات قائمة على الخلايا للتحكم في رؤية الكود، والاختبار، وتوليد التوثيق، مما يسمح للمطورين بالحفاظ على كود مصدري نظيف ومعياري أثناء العمل في بيئة تفاعلية. بعيداً عن سير عمل التطوير الأساسي الخاص به، يوفر المشروع مجموعة قوية من أدوات الأتمتة لدورة حياة البرمجيات بأكملها. يتضمن ذلك محرك موقع ثابت لتقديم توثيق بدرجة النشر مع دعم للمعادلات الرياضية والإسناد الترافقي للرموز، بالإضافة إلى أدوات مساعدة لإدارة تبعيات المشروع، والإصدار، والاختبار المؤتمت. كما يدعم سير عمل التكامل المستمر لنشر التوثيق ونشر الحزم في السجلات القياسية. يوفر المشروع عملية تمهيد موحدة لتهيئة مستودعات جديدة بخطوط أنابيب مهيأة مسبقاً للاختبار والتوثيق والتحكم في الإصدار.

هذا المشروع هو موقع التوثيق الرسمي لـ Kubernetes، ويعمل كمورد تقني شامل لإدارة التطبيقات المعبأة. يعمل كبوابة توثيق تقنية مفتوحة المصدر توفر أدلة، ودروسًا تعليمية، ومواد مرجعية لبرمجيات الأنظمة الموزعة. تم بناء الموقع باستخدام مولد مواقع ثابت مع بنية قالب قائمة على المكونات للحفاظ على أنماط تصميم متسقة. ويتميز بمولد توثيق OpenAPI الذي يحلل المواصفات التقنية لبناء وتحديث صفحات مرجع واجهة برمجة التطبيقات المهيكلة تلقائيًا. لدعم جمهور عالمي، يستخدم توجيه المحتوى الواعي بالتدويل لإدارة الإصدارات المترجمة من الأدلة. يتضمن سير عمل التطوير خادم إعادة تحميل ساخن لمعاينة تغييرات الموقع وعرض اللغة المستهدف لتسريع أوقات البناء. يغطي المشروع مجموعة واسعة من المجالات التقنية، بما في ذلك تنسيق العناقيد، وتهيئة الشبكة، وإدارة الموارد.

Crab هي لغة برمجة أنظمة آمنة للذاكرة ومترجم مسبق (ahead-of-time) مصمم للبرمجيات عالية الأداء. تستخدم نظام أنواع يعتمد على قواعد ملكية واقتراض صارمة لمنع أخطاء الوصول إلى الذاكرة في وقت الترجمة. تتضمن سلسلة الأدوات مولد وثائق آلي ينتج أدلة مرجعية تقنية وأدلة API عن طريق تحليل تعليقات الكود المصدري المهيكلة. كما تتميز بأداة إدارة تبعيات لحل رسوم بيانية للمكتبات الخارجية وضمان بناء مشاريع متسقة. يغطي المشروع أتمتة بناء البرمجيات، والتحقق من النوع الثابت، والتحليل الثابت متعدد التمريرات للتحقق من القيود قبل إنشاء ثنائيات أصلية للجهاز.

FastStream is an asyncio message broker framework for building event-driven applications in Python. It provides a unified interface and a multi-broker messaging abstraction layer that translates generic producer and consumer calls into broker-specific APIs. The framework features a built-in dependency injection container and uses decorators to route messages to asynchronous handler functions. It includes a documentation generator that extracts channel definitions and message formats from code to produce standardized AsyncAPI specifications. The project supports integration with Kafka, Rabbit