From 0441f050cc5520fa4953029df8261ff490f3b455 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomasz=20Kali=C5=84ski?= <tomkalon@gmail.com>
Date: Fri, 13 Sep 2024 15:46:11 +0200
Subject: [PATCH] OP-535 - installation.md - new standard

---
 README.md           | 36 ++++++++++++-----------------
 doc/installation.md | 55 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 69 insertions(+), 22 deletions(-)
 create mode 100644 doc/installation.md

diff --git a/README.md b/README.md
index c4275ee..2057127 100644
--- a/README.md
+++ b/README.md
@@ -46,8 +46,8 @@ We have a 70-person team of experts: business analysts and consultants, eCommerc
 ---
 * [Overview](#overview)
 * [Installation](#installation)
-  * [Customization](#customization)
-  * [Testing](#testing)
+* [Customization](#customization)
+* [Testing](#testing)
 * [Functionalities](#functionalities)
 * [Demo](#demo)
 * [Additional resources for developers](#additional-resources-for-developers)
@@ -62,31 +62,23 @@ We have a 70-person team of experts: business analysts and consultants, eCommerc
 The Braintree Plugin seamlessly integrates the Braintree payment gateway into your Sylius eCommerce platform, enabling a straightforward and secure shopping experience for your customers. As an open-source addition to the Sylius ecosystem, this plugin brings together the comprehensive features of both Sylius and Braintree, facilitating not only payment processing but also order refunds.
 
 
+## Installation
 
-
-# Installation
 ---
+### Requirements
 
-```bash
-$ composer require bitbag/braintree-plugin 
-```
-    
-Add plugin dependencies to your config/bundles.php file:
+We work on stable, supported and up-to-date versions of packages. We recommend you to do the same.
 
-```php
-return [
-   BitBag\SyliusBraintreePlugin\BitBagSyliusBraintreePlugin::class => ['all' => true]
-];
-```
-
-Import configuration:
+| Package       | Version         |
+|---------------|-----------------|
+| PHP           | \>=8.0          |
+| sylius/sylius | 1.12.x - 1.13.x |
+| MySQL         | \>= 5.7         |
+| NodeJS        | \>= 18.x        |
+----
 
-```yaml
-imports:
-    ...
-    
-    - { resource: "@BitBagSyliusBraintreePlugin/Resources/config/config.yml" }
-```
+### Full installation guide
+- [See the full installation guide](doc/installation.md)
 
 ## Customization
 ----
diff --git a/doc/installation.md b/doc/installation.md
new file mode 100644
index 0000000..765901b
--- /dev/null
+++ b/doc/installation.md
@@ -0,0 +1,55 @@
+# Installation
+
+## Overview:
+GENERAL
+- [Requirements](#requirements)
+- [Composer](#composer)
+- [Basic configuration](#basic-configuration)
+---
+ADDITIONAL
+- [Known Issues](#known-issues)
+---
+
+## Requirements:
+We work on stable, supported and up-to-date versions of packages. We recommend you to do the same.
+
+| Package       | Version         |
+|---------------|-----------------|
+| PHP           | \>8.0           |
+| sylius/sylius | 1.12.x - 1.13.x |
+| MySQL         | \>= 5.7         |
+| NodeJS        | \>= 18.x        |
+
+## Composer:
+```bash
+composer require bitbag/braintree-plugin 
+```
+
+## Basic configuration:
+Add plugin dependencies to your `config/bundles.php` file:
+
+```php
+# config/bundles.php
+
+return [
+    //...
+    BitBag\SyliusBraintreePlugin\BitBagSyliusBraintreePlugin::class => ['all' => true]
+];
+```
+
+Import required config in your `config/packages/_sylius.yaml` file:
+
+```yaml
+# config/packages/_sylius.yaml
+
+imports:
+    #...
+    - { resource: "@BitBagSyliusBraintreePlugin/Resources/config/config.yml" }
+```
+
+## Known issues
+### Translations not displaying correctly
+For incorrectly displayed translations, execute the command:
+```bash
+bin/console cache:clear
+```