Skip to content

Maintainer Documentation

Comprehensive documentation, workflows, build matrix, and release procedures for siddiqsoft::sip2json maintainers and contributors.


Maintainer Topics

flowchart TD
    MG["Maintainer Guide (maintainer_guide.md)"]
    MG --> WF["Local Workflow (workflow.md)"]
    MG --> CP["CMake Presets (cmake_presets.md)"]
    MG --> PL["CI/CD Pipelines (pipelines.md)"]
    MG --> BA["Build Agents (build_agents.md)"]
    MG --> RL["Release Lifecycle (releases.md)"]
    MG --> DC["Documentation (documentation.md)"]

Directory of Guides

Guide Description
Maintainer Guide Codebase architecture, UML directive grammar (@@uml-diag:), class diagrams, and bulk clang-format instructions
CI/CD Pipelines Multi-platform pipeline architecture, platform matrix, and parameters reference
CMake Presets Decoupled presets hierarchy, project-base.json, and preset reference
Development Workflow Local building, testing, standalone validation subproject, and macOS toolchain management
Build Agent Requirements Prerequisites and configuration for macOS, Linux, and Windows self-hosted agents
Release & Publication Lifecycle GitVersion, SemVer tagging, GitHub Releases, and NuGet package publishing
Documentation Architecture MkDocs Material, Doxygen XML, custom CSS tokens, hooks, and local preview