docs: Improve docs (#1518)

# Description

- how to add main branch as git dependency
- link screenshots to example code
- getting started with the most common use case

Author: Gustl22

contributing.md

@@ -34,6 +34,42 @@ You should only need to run this command once.
 
 > You do not need to run `flutter pub get` once bootstrap has been completed.
 
+### Current Development
+
+If you want to use the most recent changes in your own project add following dependencies to your `pubspec.yaml` or `pubspec_overrrides.yaml`:
+
+```yaml
+dependency_overrides:
+  audioplayers:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers'
+  audioplayers_platform_interface:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_platform_interface'
+  audioplayers_web:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_web'
+  audioplayers_linux:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_linux'
+  audioplayers_android:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_android'
+  audioplayers_darwin:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_darwin'
+  audioplayers_windows:
+    git:
+      url: https://github.com/bluefireteam/audioplayers.git
+      path: 'packages/audioplayers_windows'
+```
+
 ## Old Issues/PRs
 
 We have many existing open issues and a few open PRs that were created before this doc was created. We will try to respect their ignorance of this file's existence by doing our best effort to answer/address/fix/merge them as we normally would up to this point (i.e. as time permits). 

packages/audioplayers/README.md

@@ -16,7 +16,7 @@
 
 ---
 
-<img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_src.png" width="25%"/><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_ctrl.png" width="25%"/><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_stream.png" width="25%"/><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_ctx.png" width="25%"/>
+<a title="Sources" href="https://github.com/bluefireteam/audioplayers/blob/main/packages/audioplayers/example/lib/tabs/sources.dart"><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_src.png" width="25%"/></a><a title="Controls" href="https://github.com/bluefireteam/audioplayers/blob/main/packages/audioplayers/example/lib/tabs/controls.dart"><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_ctrl.png" width="25%"/></a><a title="Streams" href="https://github.com/bluefireteam/audioplayers/blob/main/packages/audioplayers/example/lib/tabs/streams.dart"><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_stream.png" width="25%"/></a><a title="Audio Context" href="https://github.com/bluefireteam/audioplayers/blob/main/packages/audioplayers/example/lib/tabs/audio_context.dart"><img src="https://raw.githubusercontent.com/bluefireteam/audioplayers/main/images/screenshot_ctx.png" width="25%"/></a>
 
 **Note**: all the docs are kept up to date to reflect the content of the current newest release. If you are looking for older information and guidance, please checkout the [tag](https://github.com/bluefireteam/audioplayers/tags) related to the version that you are looking for.
 
@@ -25,7 +25,12 @@ If you are interest in migrating major versions, please check the [changelog](CH
 
 ## Getting Started
 
-We tried to make audioplayers as simple to use as possible.
+We tried to make audioplayers as simple to use as possible:
+
+```dart
+final player = AudioPlayer();
+await player.play(UrlSource('https://example.com/my-audio.wav'));
+```
 
 Please follow our [Getting Started tutorial](https://github.com/bluefireteam/audioplayers/blob/main/getting_started.md) for all high-level information you need to know.