Repository Structure¶

Field	Value
Reference	ADR-002
Type	ADR
Version	1.00
Status	Approved
Owner	Technical Lead
Approver	Board
Approval Record
Effective Date	2026-08-05
Next Review	2027-08-05
Review Requirements	As defined in STD-001
Classification	Internal

Purpose¶

This Architectural Decision Record defines the repository structure used by BRSA and records the rationale for adopting it.

Scope¶

This decision applies to all source code, documentation, configuration and other digital assets maintained by BRSA.

Decision¶

BRSA maintains three primary Git repositories.

governance¶

Contains the organisational governance framework, including:

Policies
Procedures
Standards
Registers
Templates
Architectural Decision Records
Public governance documents
Internal member documentation
Board documentation

This repository defines how BRSA operates as an organisation.

brsaweb-platform¶

Contains everything required to build, configure and operate the BRSA website.

Examples include:

Ghost configuration
Themes
Custom integrations
Website assets
Platform scripts
Platform documentation

This repository defines the website platform.

infrastructure¶

Contains the technical infrastructure supporting BRSA services.

Examples include:

Infrastructure as Code
Virtual machine configuration
Networking
DNS
Email services
Monitoring
Backup configuration
Deployment automation
Infrastructure documentation

This repository defines how BRSA systems are deployed, hosted and operated.

Rationale¶

Several repository structures were considered.

A single repository would unnecessarily combine governance, application and infrastructure concerns.

A larger number of specialised repositories would introduce additional administration with little benefit for a volunteer-led organisation.

Three repositories provide a clear separation of responsibilities while remaining simple to understand and maintain.

Principles¶

The following principles apply:

Each repository has a single, clearly defined purpose.
Documentation should reside with the subject it describes.
Governance documentation shall not duplicate technical implementation documentation.
Technical repositories shall not duplicate governance documentation.
Duplication between repositories should be avoided.
Additional repositories should only be created where a clear architectural boundary exists.

Consequences¶

This decision provides:

clear ownership of documentation and code
straightforward navigation
separation of organisational governance from technical implementation
reduced duplication
a structure that can grow without unnecessary complexity

ADR-001 Engineering and Documentation Principles
STD-001 Document Standard
STD-003 Repository Standard

Review Requirements¶

This decision shall be reviewed in accordance with STD-001 and whenever the repository structure no longer meets the operational needs of BRSA.

Change History¶

Version	Date	Author	Change
0.10	2026-07-23	Technical Lead	Initial draft
0.50	2026-07-24	DC	Version -> 0.50; Status -> Review
0.50	2026-08-05	DC	Status -> Approved; Effective Date -> 2026-08-05; Last Reviewed -> 2026-08-05; Next Review -> 2027-08-05
1.00	2026-08-05	DC	Version -> 1.00; Status -> Approved; Effective Date -> 2026-08-05; Last Reviewed -> 2026-08-05; Next Review -> 2027-08-05