modify for v0.3.0-release

change changelog-link
modify examples
add references/usedBy

Author: johguentner

README.md

@@ -36,14 +36,16 @@ Head over to the [Documentation](https://5amco.de/docs) of this package.
 
 ### 🔥 Code Examples to jumpstart your Notion API Project
 
-#### Basic Setup
-
+#### Basic Setup (+ example)
 ```php
-use FiveamCode\LaravelNotionApi\Notion;
+use FiveamCode\LaravelNotionApi\Notion; 
+
+# Access through Facade (token has to be set in .env)
+\Notion::databases()->find($databaseId);
 
-// Setup basic API connection
-$notion = new Notion();
-$notion->v1();
+# Custom instantiation (necessary if you want to access more than one NotionApi integration)
+$notion = new Notion($apiToken, $apiVersion); // version-default is 'v1'
+$notion->databases()->find($databaseId);
 ```
 
 #### Fetch Page Information
@@ -52,6 +54,14 @@ $notion->v1();
 $notion->pages()->find($yourPageId);
 ```
 
+#### Search
+```php
+// Returns a collection pages and databases of your workspace (included in your integration-token)
+\Notion::search($searchText)
+        ->query()
+        ->asCollection();
+```
+
 #### Query Database
 
 ```php
@@ -70,17 +80,15 @@ $filters
 $filters
   ->add(Filter::rawFilter('Tags', ['multi_select' => ['contains' => 'great']]));
 
-$notion
-  ->database($yourDatabaseId)
-  ->filterBy($filters) // filters are optional
-  ->sortBy($sortings) // sorts are optional
-  ->limit(5) // limit is optional
-  ->query(); 
+\Notion::database($yourDatabaseId)
+      ->filterBy($filters) // filters are optional
+      ->sortBy($sortings) // sorts are optional
+      ->limit(5) // limit is optional
+      ->query()
+      ->asCollection();
 ```
 
 
-
-
 ### Testing
 
 ```bash
@@ -89,7 +97,11 @@ vendor/bin/phpunit tests
 
 ### Changelog
 
-Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
+Please see [CHANGELOG](https://5amco.de/docs/0.3.0/changelog) for more information what has changed recently.
+
+## References / UsedBy
+
+- Julien Nahum created [notionforms.io](https://notionforms.io) with [laravel-notion-api](https://github.com/5am-code/laravel-notion-api), which allows you to easily create custom forms, based on your selected database within notion.
 
 ## Contributing