diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..18d432c --- /dev/null +++ b/.editorconfig @@ -0,0 +1,15 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true +indent_style = space +indent_size = 4 + +[*.md] +trim_trailing_whitespace = false + +[*.{yml,yaml}] +indent_size = 2 diff --git a/docs/CODE_STYLE.md b/docs/CODE_STYLE.md new file mode 100644 index 0000000..a358117 --- /dev/null +++ b/docs/CODE_STYLE.md @@ -0,0 +1,32 @@ +# Code Style Guidelines + +## Kotlin Style + +MediaKit follows: +- Kotlin-first APIs +- Readable code +- Minimal public APIs +- Clear separation of responsibilities + +## General Rules + +- Prefer immutable data where possible +- Keep functions focused +- Avoid large god classes +- Prefer composition over deep inheritance + +## SDK Priorities + +Higher priority than feature count: +- Stability +- Readability +- Maintainability +- Bitmap safety +- Lifecycle correctness + +## Public API Guidelines + +- Keep APIs predictable +- Avoid leaking internal implementation +- Prefer builder-style APIs when useful +- Keep module boundaries clean diff --git a/docs/MAINTENANCE_GUIDE.md b/docs/MAINTENANCE_GUIDE.md new file mode 100644 index 0000000..1b049c5 --- /dev/null +++ b/docs/MAINTENANCE_GUIDE.md @@ -0,0 +1,35 @@ +# Maintenance Guide + +## Goals + +MediaKit maintenance should focus on: +- Stability +- Backward compatibility +- Lightweight architecture +- Reliable media handling + +## Recommended Maintenance Areas + +### Image Picker +- Permission flow validation +- Lifecycle testing +- Camera integration testing +- URI handling verification + +### Image Cropper +- Crop accuracy validation +- Bitmap memory monitoring +- Matrix transformation validation +- Large image testing + +## Release Maintenance + +Before releases: +- Verify CI builds +- Review public API changes +- Update changelog +- Validate sample app + +## Long-Term Direction + +MediaKit should evolve carefully while keeping APIs stable and modular.