Improvements to the doc (#1989)

* Added Overview page

* Revised Getting Started page

* Minor revision

* Edited readme, minor modifications to docs

* Removed sweep.yaml, .devcontainer, .ergomake

* Moved security.md to .github, added contributing.md

* changes as per code review

* updated contributing.md

* fixed broken links & added missing links in doc, improved structure

* fixed link in wsl setup

* fixed server link, added https cloning in yarn-setup

* removed package-lock.json

* added doc card, admonitions

* removed underline from nav buttons

docs/docs/contributor/local-setup/_category_.json

@@ -6,4 +6,4 @@
   "customProps": {
     "icon": "TbDeviceDesktop"
   }
-}
+}

docs/docs/contributor/local-setup/docker-setup.mdx

@@ -1,6 +1,7 @@
 ---
 title: Docker Setup
 sidebar_position: 2
+description: Set up the project with Docker.
 sidebar_custom_props:
   icon: TbBrandDocker
 ---
@@ -46,7 +47,11 @@ PG_DATABASE_URL=postgres://twenty:twenty@postgres:5432/default?connection_limit=
 We provide an environment containerized with Docker and orchestrated with `docker-compose`.
 This installation method will also provision a PostgreSQL container.
 
-> **Note:** The configuration for the build is stored in the `infra/dev` folder, but you can run `make` commands directly from the root folder.
+:::info
+
+The configuration for the build is stored in the `infra/dev` folder, but you can run `make` commands directly from the root folder.
+
+:::
 
 ```bash
 make build

docs/docs/contributor/local-setup/ide-setup.mdx

@@ -1,11 +1,12 @@
 ---
 title: IDE Setup
 sidebar_position: 4
+description: Our recommended IDE set up. 
 sidebar_custom_props:
   icon: TbBrandVscode
 ---
 
-This section will help you setup your IDE for the project. If you haven't setup your development environment, please refer to our [local setup](/contributor/local-setup) section.
+This section will help you set up your IDE for the project. If you haven't setup your development environment, please refer to our [local setup](/contributor/local-setup) section.
 
 
 ## Visual Studio Code

docs/docs/contributor/local-setup/local-setup.mdx

@@ -7,9 +7,14 @@ sidebar_custom_props:
 import ThemedImage from '@theme/ThemedImage';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import DocCardList from '@theme/DocCardList';
+
+
 
 Twenty is designed to be developer-friendly, and your local installation should be up and running in a few minutes.
 
+<DocCardList/>
+
 ## Discord
 
 If you have any questions or need help, you can join our [Discord](https://twenty.com/discord) server.

docs/docs/contributor/local-setup/troubleshooting.mdx

@@ -1,6 +1,7 @@
 ---
 title: Troubleshooting
 sidebar_position: 5
+description: Common problems & their solutions.
 sidebar_custom_props:
   icon: TbExclamationCircle
 ---

docs/docs/contributor/local-setup/wsl-setup.mdx

@@ -1,6 +1,7 @@
 ---
 title: Windows WSL Setup
 sidebar_position: 3
+description: Install the project with WSL2.
 sidebar_custom_props:
   icon: TbBrandWindows
 ---
@@ -37,8 +38,11 @@ Then, configure your git user name and email using the following commands, repla
 git config --global user.name "Your Name"
 git config --global user.email "youremail@domain.com"
 ```
+:::note
 
->**Note:** If you don't have a Github account, create one now with the corresponding email address. We recommend that you setup a SSH key for your Github account. Follow the instructions [here](https://docs.github.com/fr/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).
+If you don't have a Github account, create one now with the corresponding email address. We recommend that you setup a SSH key for your Github account. Follow the instructions [here](https://docs.github.com/fr/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).
+
+:::
 
 ### Step #2: Install Node.js, nvm, Yarn
 

docs/docs/contributor/local-setup/yarn-setup.mdx

@@ -1,6 +1,7 @@
 ---
 title: Yarn Setup
 sidebar_position: 1
+description: "Set up the project with Yarn."
 sidebar_custom_props:
   icon: TbScript
 ---
@@ -9,8 +10,11 @@ import TabItem from '@theme/TabItem';
 
 In this document, you'll learn how to install the project using yarn. We recommend this method since it's the easiest way to get started but you can also run the project with [Docker](/contributor/local-setup/docker-setup) or [WSL2](/contributor/local-setup/wsl-setup).  
 
+:::info
 
-> **Note:** `npm` currently does not support local packages satisfactorily. We strongly recommend using `yarn` instead.
+`npm` currently does not support local packages satisfactorily. We strongly recommend using `yarn` instead.
+
+:::
 
 ## Prerequisites
 
@@ -119,7 +123,11 @@ cp ./server/.env.example ./server/.env
 
 ## Step #4: Server setup
 
-> **Note:** We recommend that you use `nvm` to install the correct `node` version. We have added a `server/.nvmrc` to ensure all contributors use the same version.
+:::info
+
+We recommend that you use `nvm` to install the correct `node` version. We have added a `server/.nvmrc` to ensure all contributors use the same version.
+
+:::
 
 To build Twenty server and seed some data into your database, run the following commands:
 ```bash
@@ -135,7 +143,12 @@ Twenty's server will be up and running at [http://localhost:3000/graphql](http:/
 
 ## Step #5: Frontend setup
 
-> **Note:** For the frontend setup, too, we recommend using `nvm` to install the right node version. 
+:::info
+
+For the frontend setup, too, we recommend using `nvm` to install the right node version. 
+
+:::
+
 To set up the frontend, run the following commands in your terminal:
 
 ```bash