diff --git a/docs/docs/ci.md b/docs/docs/ci.md
new file mode 100644
index 0000000000..31247a8432
--- /dev/null
+++ b/docs/docs/ci.md
@@ -0,0 +1,30 @@
+# CI
+
+## TLDR;
+
+- This repo is a Multi-Language repo.
+- We use Nix & Bazel to manage project dependencies
+- We use direnv to load all environment varialbes needed on the project
+- For the frontend projects we use Yarn Workspaces.
+- Currently we have 2 projects: Desktop app and Sites
+- the Desktop app is built entirely on Github actions
+- Sites are built as a Docker container for easy deployment 
+- We create a new release of both projects every Tuesday in the morning automatically
+- If we need to create a new release manually, we need to push a tag to the `master` branch and the process will start.
+- version numbers follow the next pattern: `<YEAR>.<MONTH>.<NTH_COMMITS_ON_MONTH>`
+- We run validation code (lint, format and test) on every push to `master` and on every PR
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/docs/frontend-code-patterns.md b/docs/docs/frontend-code-patterns.md
new file mode 100644
index 0000000000..89bb529004
--- /dev/null
+++ b/docs/docs/frontend-code-patterns.md
@@ -0,0 +1,11 @@
+# Frontend code patterns
+
+This file aims to show all the frontend code patterns we (try!) to follow throughout all the application. This tries to cover the best practices that suits us based on the technology and tools we chose to use in the app.
+
+> This is a Living document, so things are in constant change.
+
+## Data Fetching
+
+### Prefer a data-first approach
+
+- because we are using `@tanstack/query`, there are situations in which we can have both `errors` and `data` at the same time, so [it is recommended](https://tkdodo.eu/blog/status-checks-in-react-query) in the [community resources](https://tanstack.com/query/v4/docs/react/community)
\ No newline at end of file