android / android-studio-poet

Large Android projects generator
Apache License 2.0
702 stars 85 forks source link

Add docs #109

Open LouisCAD opened 6 years ago

LouisCAD commented 6 years ago

Hi, The example in the README is not sufficient for masses to start using this confidently. There's a documentation need to explain what you can do, how, in order to developers to start using it.

I see a great potential for this project as multi-module projects are becoming more and more common with multiple Android targets (Wear OS, TV, Auto Things...), Instant Apps and feature modules, Kotlin multiplatform, App bundle with optional app extension modules.

When I start a new project (like when starting an open source library with sample modules), configuring all the modules is the biggest burden, especially with countless gradle syncs needed as I need to add modules, and add dependencies. Android Studio Poet would probably help, but getting started is far from being straightforward, with not even a snippet I can copy, paste and edit, and the screenshot in the example is not even a working one.

If you want inspiration for examples, just make a config file that generates a project that includes all the Android Jetpack libraries, and an instant app 3 features project.

borisf commented 6 years ago

Thanks Loius. We would like to understand better the points you raised: