2026-05-17 14:48:52 -04:00
|
|
|
# Contributing
|
2025-08-09 13:23:20 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
## Development workflow
|
2025-08-09 13:23:20 -04:00
|
|
|
|
2025-08-27 13:25:26 -04:00
|
|
|
```bash
|
2026-05-17 14:48:52 -04:00
|
|
|
npm install
|
|
|
|
|
npm test
|
|
|
|
|
npm audit
|
|
|
|
|
npm run build
|
2025-08-27 13:25:26 -04:00
|
|
|
```
|
|
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
## Security-sensitive areas
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
Changes involving any of the following require extra review and focused tests:
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
- SAS verification and protocol compatibility
|
|
|
|
|
- WebRTC ICE/TURN behavior
|
|
|
|
|
- encrypted payload validation or display sanitization
|
|
|
|
|
- file-transfer consent and type policy
|
|
|
|
|
- IndexedDB migration logic
|
|
|
|
|
- disconnect and resource lifecycle cleanup
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
## Documentation expectations
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
When behavior changes, update the corresponding release-facing documentation in the same change:
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
- `README.md`
|
|
|
|
|
- `SECURITY.md`
|
|
|
|
|
- `doc/CONFIGURATION.md`
|
|
|
|
|
- `doc/CRYPTOGRAPHY.md`
|
|
|
|
|
- `doc/SECURITY-ARCHITECTURE.md`
|
|
|
|
|
- `CHANGELOG.md`
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
## Pull requests
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
Please include:
|
2025-08-27 13:25:26 -04:00
|
|
|
|
2026-05-17 14:48:52 -04:00
|
|
|
- concise problem statement
|
|
|
|
|
- implementation summary
|
|
|
|
|
- tests run
|
|
|
|
|
- regression risks
|
|
|
|
|
- screenshots or logs for user-visible changes when relevant
|