Repository Standard¶
| Field | Value |
|---|---|
| Reference | STD-003 |
| Type | Standard |
| 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¶
To define standards for organising and maintaining BRSA Git repositories.
Scope¶
This standard applies to all repositories owned and maintained by BRSA.
Repository Structure¶
Repositories shall be organised by subject area.
Each repository shall contain a README describing its purpose.
Source Control¶
Git is the authoritative source for all controlled documentation.
Repositories shall preserve complete change history.
Commits¶
Commits shall represent a single logical change.
Commit messages should describe why the change was made.
Branches¶
The default branch shall contain the current approved state of the repository.
Additional branches may be used where appropriate.
Archive¶
Superseded documents shall be retained in accordance with STD-001.
Repository history shall not be rewritten except where necessary to protect sensitive information.
Related Documents¶
- ADR-001 Engineering and Documentation Principles
- STD-001 Document Standard
Review Requirements¶
As defined in STD-001.
Change History¶
| Version | Date | Author | Summary |
|---|---|---|---|
| 0.10 | YYYY-MM-DD | 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 |