Skip to content

Jersal Hub

Welcome to the central project management hub for the Jersal organization. This is the single source of truth for how we build, what we build, and why we make the decisions we do.

Quick navigation

  • Organization

    Understand the Jersal family: core infrastructure, project template, and how repositories relate to each other.

    Organization overview

  • Projects

    Registry of all active and planned projects with status, tech stack, and links to their repositories.

    Project registry

  • Standards

    Coding conventions, naming patterns, and architecture principles that every project follows.

    Standards overview

  • ADRs

    Architecture Decision Records documenting the reasoning behind key technical choices.

    ADR index

  • Infrastructure

    Azure infrastructure documentation: architecture, RBAC, OIDC setup, state backends, and operational runbooks.

    Architecture

What is this hub?

This hub serves as a Confluence-like knowledge base for the Jersal organization, built with Material for MkDocs and powered by plain Markdown files stored in Git.

Key properties:

  • Content is version-controlled alongside infrastructure code in jersal-projects-core
  • Fully searchable with instant client-side search
  • Deployed as a static site on Azure Static Web Apps
  • Contributions follow the same Git workflow as code changes

Hub architecture

graph TB
    HUB["Jersal Hub<br/>(hub.jersal.net)"]

    HUB --> ORG["Organization"]
    HUB --> PROJ["Project Registry"]
    HUB --> STD["Standards"]
    HUB --> ADR["ADRs"]
    HUB --> INFRA["Infrastructure"]

    PROJ --> ML["MenuLoft<br/>(repo docs)"]
    PROJ --> DTD["Dev Tooling Dashboard<br/>(repo docs)"]
    PROJ --> RCE["Realtime Collab Editor<br/>(repo docs)"]
    PROJ --> PA["Personal Analytics<br/>(repo docs)"]

Each project has its own docs/ folder in its repository. The hub provides organization-wide context and links to project-specific documentation.