USB-Meter
/
Documentation
/
README.md
Newer
■
■
■
■
■
■
■
■
■
■
Older
38 lines
|
1.235kb
| 1 |
# Documentation |
|
| 2 | ||
| 3 |
This folder contains project notes, platform decisions, and collected reverse engineering material. |
|
| 4 | ||
| 5 |
It is intended to keep the repository root focused on the app itself while preserving project context in one dedicated place. |
|
| 6 | ||
| 7 |
## Working Layout |
|
| 8 | ||
| 9 |
- `Project History.md` |
|
| 10 |
Narrative context and decisions that explain how the project got here. |
|
| 11 |
- `Platform Decision - iOS 15.md` |
|
| 12 |
App-level platform choices that affect implementation. |
|
| 13 |
- `Research Resources/` |
|
| 14 |
External source material plus the notes derived from it. |
|
| 15 | ||
| 16 |
## Documentation Layers |
|
| 17 | ||
| 18 |
We keep two distinct layers of documentation: |
|
| 19 | ||
| 20 |
- project documentation |
|
| 21 |
Notes that describe our app, decisions, assumptions, and roadmap |
|
| 22 |
- research documentation |
|
| 23 |
Vendor manuals, software archives, contact sheets, protocol notes, and model-specific findings |
|
| 24 | ||
| 25 |
## Retention Rule |
|
| 26 | ||
| 27 |
Prefer keeping: |
|
| 28 | ||
| 29 |
- small curated Markdown notes |
|
| 30 |
- raw manuals and reference PDFs |
|
| 31 |
- small software artifacts that are directly useful for reverse engineering |
|
| 32 |
- one canonical copy of each vendor artifact line |
|
| 33 | ||
| 34 |
Avoid committing by default: |
|
| 35 | ||
| 36 |
- very large archives with low immediate value |
|
| 37 |
- duplicate files already represented elsewhere |
|
| 38 |
- generated exports that can be reproduced from a kept source |