From f17f7d7559a55cfaa48ce6ed732bcf0d334b8186 Mon Sep 17 00:00:00 2001
From: wojciech <wojciech@init.biz>
Date: Mon, 5 Jan 2026 13:41:09 +0100
Subject: [PATCH] Move documentation to the Readme.md

---
 README.md | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b0a65c3..daa4a0a 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,33 @@
-# GusApi - Use GUS API to get information from REGON in your project. 
+# GusApi - Use GUS API to get information from REGON in your project.
+
 ![GusApi banner](https://raw.githubusercontent.com/initbiz/gusapi-plugin/master/docs/gus-api.png)
 
 This is a repo of OctoberCMS plugin by [InIT.biz](https://init.biz).
 
-For full documentation visit [https://docs.init.biz/article/gus-api](https://docs.init.biz/article/gus-api) or go to [OctoberCMS's marketplace](https://octobercms.com/plugin/initbiz-gusapi).
\ No newline at end of file
+## Introduction
+
+Our Gus Api plugin give you acces to the johnzuk/GusApi library from within October.
+
+The library is based on the official REGON SOAP API.
+
+## Installation
+
+If you want to connect to the testing version, then install the plugin and you are ready to go.
+
+If you want to connect to production, ensure you have:
+
+-   `APP_ENV` in you `.env` file set to `production`
+-   entered your key in backend settings.
+
+### Example usage
+
+```php
+    use Initbiz\GusApi\Classes\GusApi;
+
+    //...
+
+    $gus = new GusApi();
+
+    //With Laravel accent ;)
+    $initbiz = collect($gus->getByNip('8661738221'))->first();
+```