diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..46a8940
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,17 @@
+# Contributing Guidelines for Wiiqare's smart contract
+We would greatly appreciate your contributions, ideas to improve or critical thoughts in the form of:
+
+- Reporting bugs
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+- Raising and discussing concerns.
+
+on Discord or via the Github issues.
+
+## We Develop with Github
+We use github to host code, to track issues and feature requests, as well as accept pull requests.
+
+## Want to add some code?
+We use [Gitflow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) for our code contribution. New branches should have
+the feature/ or hotfix/ prefix, the issue number and title, for example: feature/smartcontract-code-coverage-#1
diff --git a/README.md b/README.md
index 7ca832b..ccfb265 100644
--- a/README.md
+++ b/README.md
@@ -16,4 +16,12 @@ On root run:
 2. To start a local node: `npm run dev`
 3. To compile the smart contracts: `npm run compile`
 4. To execute the unit tests: `npm run test`
-5. To deploy a smart contract `npx hardhat run --network localhost scripts/deployWiiQareVoucherV1.ts` (change the network option for deploying on testnet to mumbai or mainnet polygon)
+5. To deploy the voucher smart contract: `npx hardhat run --network localhost scripts/deployWiiQareVoucherV1.ts` (change the network option for deploying on testnet to mumbai or mainnet polygon)
+
+## FAQ
+
+1. Q: Why the voucher smart contract is not upgradable.
+   A: We want to provide trust to our users.
+2. Q: Why isn't the solution fully decentralize.
+   A: We had to make some compromises until users will know how to properly use a wallet. Because we are dealing with providing methods for the users to pay
+   for their healthcare services, ease of use and speed were our top concerns and we chose to put decentralization on the second place.
\ No newline at end of file
diff --git a/resources/wiiqare_architecture.png b/resources/wiiqare_architecture.png
index 6470178..caf6e11 100644
Binary files a/resources/wiiqare_architecture.png and b/resources/wiiqare_architecture.png differ