Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
104 changes: 104 additions & 0 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# Clone the repository

git clone <https://github.com/hyperpolymath/dotmatrix-fileprinter.git>
cd dotmatrix-fileprinter

# Using Guix (recommended for reproducibility)

guix develop

# Or using toolbox/distrobox

toolbox create dotmatrix-fileprinter-dev toolbox enter
dotmatrix-fileprinter-dev \# Install dependencies manually

# Verify setup

just check \# or: cargo check / mix compile / etc. just test \# Run test
suite


### Repository Structure

dotmatrix-fileprinter/ ├── src/ \# Source code (Perimeter 1-2) ├── lib/
\# Library code (Perimeter 1-2) ├── extensions/ \# Extensions (Perimeter
2) ├── plugins/ \# Plugins (Perimeter 2) ├── tools/ \# Tooling
(Perimeter 2) ├── docs/ \# Documentation (Perimeter 3) │ ├──
architecture/ \# ADRs, specs (Perimeter 2) │ └── proposals/ \# RFCs
(Perimeter 3) ├── examples/ \# Examples (Perimeter 3) ├── spec/ \# Spec
tests (Perimeter 3) ├── tests/ \# Test suite (Perimeter 2-3) ├──
.well-known/ \# Protocol files (Perimeter 1-3) ├── .github/ \# GitHub
config (Perimeter 1) │ ├── ISSUE_TEMPLATE/ │ └── workflows/ ├──
CHANGELOG.md ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md \# This file ├──
GOVERNANCE.md ├── LICENSE ├── MAINTAINERS.md ├── README.adoc ├──
SECURITY.md ├── flake.guix \# Guix flake (Perimeter 1) └── justfile \#
Task runner (Perimeter 1)


---

## How to Contribute

### Reporting Bugs

**Before reporting**:
1. Search existing issues
2. Check if it's already fixed in `main`
3. Determine which perimeter the bug affects

**When reporting**:

Use the [bug report template](.github/ISSUE_TEMPLATE/bug_report.md) and include:

- Clear, descriptive title
- Environment details (OS, versions, toolchain)
- Steps to reproduce
- Expected vs actual behaviour
- Logs, screenshots, or minimal reproduction

### Suggesting Features

**Before suggesting**:
1. Check the [roadmap](ROADMAP.md) if available
2. Search existing issues and discussions
3. Consider which perimeter the feature belongs to

**When suggesting**:

Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) and include:

- Problem statement (what pain point does this solve?)
- Proposed solution
- Alternatives considered
- Which perimeter this affects

### Your First Contribution

Look for issues labelled:

- [`good first issue`](https://github.com/hyperpolymath/dotmatrix-fileprinter/labels/good%20first%20issue) — Simple Perimeter 3 tasks
- [`help wanted`](https://github.com/hyperpolymath/dotmatrix-fileprinter/labels/help%20wanted) — Community help needed
- [`documentation`](https://github.com/hyperpolymath/dotmatrix-fileprinter/labels/documentation) — Docs improvements
- [`perimeter-3`](https://github.com/hyperpolymath/dotmatrix-fileprinter/labels/perimeter-3) — Community sandbox scope

---

## Development Workflow

### Branch Naming

docs/short-description \# Documentation (P3) test/what-added \# Test
additions (P3) feat/short-description \# New features (P2)
fix/issue-number-description \# Bug fixes (P2) refactor/what-changed \#
Code improvements (P2) security/what-fixed \# Security fixes (P1-2)


### Commit Messages

We follow [Conventional Commits](https://www.conventionalcommits.org/):

():

\[optional body\]

\[optional footer\]
File renamed without changes.
File renamed without changes.
4 changes: 2 additions & 2 deletions .github/workflows/dogfood-gate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ jobs:

- name: Validate A2ML manifests
if: steps.detect.outputs.count > 0
run: bash .githooks/validate-a2ml.sh
run: bash .github/hooks/validate-a2ml.sh
- name: Write summary
run: |
A2ML_COUNT="${{ steps.detect.outputs.count }}"
Expand Down Expand Up @@ -84,7 +84,7 @@ jobs:

- name: Validate K9 contracts
if: steps.detect.outputs.k9_count > 0
run: bash .githooks/validate-k9.sh
run: bash .github/hooks/validate-k9.sh
- name: Write summary
run: |
K9_COUNT="${{ steps.detect.outputs.k9_count }}"
Expand Down
109 changes: 0 additions & 109 deletions CONTRIBUTING.adoc

This file was deleted.

Loading