Add advanced Go use cases

Author: dsame

docs/adrs/0000-caching-dependencies.md

@@ -28,7 +28,7 @@ We don't pursue the goal to provide wide customization of caching in scope of `a
 
 # Example of real use-cases
 
- - With cache
+## With cache
 
 ```yml
 steps:
@@ -63,6 +63,56 @@ steps:
         **/go.mod
 ```
 
+ ```yml
+steps:
+- uses: actions/checkout@v3
+- uses: actions/setup-go@v3
+  with:
+    go-version: '18'
+    cache: true
+    cache-dependency-path: **/go.sum
+```
+
+## Multi-target builds
+```yaml
+env:
+  GOOS: ...
+  GOARCH: ...
+
+steps:
+  - run: echo "$GOOS $GOARCH"> /tmp/env
+
+  - uses: actions/setup-go@v4
+    with:
+      cache-dependency-path: go.sum /tmp/env      
+```
+
+## Invalidate cache if source code changes
+```yaml
+- uses: actions/setup-go@v4
+  with:
+    go-version: '1.20'
+    cache-dependency-path: go.sum **/*.go
+```
+
+## Restore-only caches
+If there are several builds on the same repo it might make sense to create a cache in one build and use it in the
+others. The action [actions/cache/restore](https://github.com/actions/cache/blob/main/restore/README.md#only-restore-cache)
+should be used in this case.
+
+## Include or exclude cached paths
+This advanced use case requires the use of
+[actions/cache](https://github.com/actions/cache/blob/main/examples.md#automatically-detect-cached-paths)
+
+## Generate different caches
+This advanced use case assumes manual definition of cache key and requires the use of
+[actions/cache](https://github.com/actions/cache/blob/main/examples.md#go---modules)
+
+## Parallel builds
+To avoid race conditions during the parallel builds they should either
+[generate their own caches](#generate-different-caches), or create the cache
+for only one build and [restore](#restore-only-caches) that cache in the other builds.
+
 # Release process
 
 As soon as functionality is implemented, we will release minor update of action. No need to bump major version since there are no breaking changes for existing users.