aprender 0.17.0

Next-generation machine learning library in pure Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# Contributing to Aprender

Thank you for your interest in contributing to Aprender!

## Development Setup

```bash
# Clone the repository
git clone https://github.com/paiml/aprender.git
cd aprender

# Build
cargo build --release

# Run tests
cargo test

# Run quality gates
make tier2
```

## Quality Standards

Aprender follows EXTREME TDD methodology with strict quality gates:

- **Test Coverage**: 95%+ required (current: 96.94%)
- **Clippy**: Zero warnings (`cargo clippy -- -D warnings`)
- **Formatting**: `cargo fmt --check`
- **Mutation Testing**: 85%+ mutation score

## Tiered Quality Gates

| Tier | When | Commands |
|------|------|----------|
| Tier 1 | On save | `cargo fmt --check && cargo clippy && cargo check` |
| Tier 2 | Pre-commit | `cargo test --lib && cargo clippy -- -D warnings` |
| Tier 3 | Pre-push | `cargo test --all && make coverage` |
| Tier 4 | CI/CD | Full mutation testing + PMAT analysis |

## Pull Request Process

1. Fork the repository
2. Create a feature branch from `main`
3. Write tests first (TDD)
4. Implement your changes
5. Ensure all quality gates pass
6. Submit PR with clear description

## Code Style

- Follow Rust idioms and conventions
- Use meaningful variable names
- Add documentation for public APIs
- Keep functions focused and small

## Reporting Issues

- Use GitHub Issues for bug reports
- Include minimal reproduction steps
- Specify Rust version and OS

## License

By contributing, you agree that your contributions will be licensed under the MIT License.