diff --git a/README.md b/README.md
index bb3cf067..408c4909 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,12 @@ Ruler is a Gradle plugin which helps you analyze the size of your Android apps.
App size is an important metric which [directly correlates with business metrics](https://medium.com/googleplaydev/shrinking-apks-growing-installs-5d3fcba23ce2) like install conversion rate. Measuring app size is straightforward, but knowing what contributes to it is not. Especially in bigger projects with hundreds or thousands of modules and third-party dependencies. Ruler provides a convenient way to find out how much each module and dependency contributes to the total size of your app by running a single Gradle task.
-
+
+
+  |
+  |
+
+
## Usage
@@ -60,6 +65,33 @@ ruler {
Once this is done, `analyzeBundle` tasks will be added for each of your app variants. Running this task will build the app and generate a HTML report, which you can use to analyze your app size. It will also generate a JSON report, in case you want to further process the data.
+## Ownership
+
+In larger organizations, Gradle modules and dependencies are is often owned by specific teams. If that's the case for your app, Ruler can help you analyze app size contributions by different teams. All you need to do is provide a YAML file listing all components and their owners:
+
+```yaml
+# Identifier for Gradle modules -> path of the module
+- identifier: :sample:app
+ owner: app-team
+
+# Identifier for dependencies -> dependency shorthand without the version
+- identifier: androidx.core:core
+ owner: core-team
+```
+
+This ownership file can be maintained manually, but in most cases it will be more practical to generate it during the build. You can point Ruler to your YAML file in the `build.gradle`, you can also configure default owners for components missing from the ownership file:
+
+```kotlin
+ruler {
+ ownershipFile.set("/path/to/ownership.yaml")
+ defaultOwner.set("default-team") // unknown by default
+}
+```
+
+When you pass an ownership file to Ruler, you'll see a new tab in the HTML report with app size insights broken down by team:
+
+
+
## Project structure
Ruler is built with Kotlin and contains multiple modules:
diff --git a/docs/breakdown.png b/docs/breakdown.png
new file mode 100644
index 00000000..32e21495
Binary files /dev/null and b/docs/breakdown.png differ
diff --git a/docs/insights.png b/docs/insights.png
new file mode 100644
index 00000000..80ef2178
Binary files /dev/null and b/docs/insights.png differ
diff --git a/docs/ownership.png b/docs/ownership.png
new file mode 100644
index 00000000..b0fab358
Binary files /dev/null and b/docs/ownership.png differ
diff --git a/docs/report.png b/docs/report.png
deleted file mode 100644
index fffcff65..00000000
Binary files a/docs/report.png and /dev/null differ