vynte-infra/twenty
2
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

Fix typos/language in docs (#824)

Browse Source 
* Fix typos/language in docs

* Fix typos
This commit is contained in:
willkrakow
2023-07-22 18:48:31 +02:00
committed by GitHub
parent 9deb46141c
commit 097627fcab
7 changed files with 68 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/docs/developer/glossary.mdx
+7 -7
View File
@@ -6,14 +6,14 @@ sidebar_custom_props:
### Workspace
A `Workspace` usually represents a company using Twenty.
It's attached to a single domain name, which is usually the domain name you company uses for your employee email addresses.
It is attached to a single domain name, which is usually the domain name your company uses for employee email addresses.
### Company & People
They are the two fundamental types of records that the CRM is built around.
A `Company` represents a business or an organization. `People` represents an individual you are doing business with or would like to do business with.
They are the two fundamental types of records that the CRM is built around:
- A `Company` represents a business or organization.
- `People` represent your company's current and prospective customers or clients.
### Pipelines
A `Pipeline` is a way to track a business process.
`Pipeline`s are categorized within a module and have stages:
- A module is the business characterizations of your process (e.g. sales, recruiting).
- Stages maps the steps in your process (e.g. new, ongoing, won, lost)
A `Pipeline` is a way to track a business process. Pipelines are categorized within a *module* and have *stages*:
- A **module** contains the logic for a certain business process (e.g. sales, recruiting).
- **Stages** map the steps in your process (e.g. new, ongoing, won, lost).
docs/docs/developer/local-setup.mdx
+40 -39
View File
@@ -10,8 +10,8 @@ This section will guide you through the Twenty installation on your local enviro
Twenty is designed to be developer-friendly, and your local installation should be up and running in a few minutes.
In a nutshell:
- We recommend using `yarn` installation but we also provide an easy way to provide the project with Docker.
- Twenty uses PostgreSQL as a database. If we don't have one available, we also provide a one-line command to provision a PostgreSQL instance through Docker.
- We recommend using `yarn` installation but we also provide an easy way to run the project with Docker.
- Twenty uses PostgreSQL as a database. If you don't a PostgreSQL instance available, we also provide a one-line command to provision one through Docker.
The repository is structured as follows:
```
@@ -19,12 +19,12 @@ twenty
└───docs // contains this documentation
└───front // contains the frontend code for the application
└───server // contains the backend code for the application
└───infra // contains docker development/production-ready deployment configuration
└───infra // contains docker configurations for development and production deployments
```
## Yarn install (recommended)
**Note:** `npm` is currently not supporting local packages satisfactorily. We strongly recommend using `yarn` instead.
**Note:** `npm` currently does not support local packages satisfactorily. We strongly recommend using `yarn` instead.
### 1. Pre-requisites
@@ -41,19 +41,19 @@ You also need to have a PosgresSQL database available. If you already have one a
If you don't, you can provision one through `docker` using the following command:
```
```bash
cd twenty
make provision-postgres
```
This will create a docker container, exposing a PostgreSQL instance at [http://localhost:5432](http://localhost:5432).
This will create a Docker container, exposing a PostgresSQL instance at [http://localhost:5432](http://localhost:5432).
### 4. Setup env variables
Twenty requires a few environment variables to be set. Locally, we recommend setting them through `.env` file.
Twenty requires a few environment variables to be set. Locally, we recommend setting them through a `.env` file.
To do so, make a copy of .env.example files:
```
To do so, make copies of the `.env.example` files in `/front` and `/server`:
```bash
cp ./front/.env.example ./front/.env
cp ./server/.env.example ./server/.env
```
@@ -65,7 +65,7 @@ The default values should work out of the box. Don't forget to update the databa
**Note:** we recommend that you use `nvm` to install the correct `node` version. We have added a `server/.nvmrc` to ensure all contributors are using the same version.
To build Twenty server and seed some data into your database:
```
```bash
cd server
nvm install #recommended
nvm use #recommended
@@ -76,11 +76,11 @@ yarn start:dev
Twenty server will be running at [http://localhost:3000](http://localhost:3000).
### 6. Front setup
### 6. Frontend setup
**Note:** similarly, we recommend that you use `nvm` to install the right node version.
```
```bash
cd ../front
nvm install #recommended
nvm use #recommended
@@ -92,30 +92,30 @@ Twenty front will be running at [http://localhost:3001](http://localhost:3001).
### 7. Sign in to your local Twenty installation
Browse [http://localhost:3001](http://localhost:3001). You can connect using our recently seeded demo account `tim@apple.dev`.
Open [http://localhost:3001](http://localhost:3001) in your web browser. You can login using our seeded demo account: `tim@apple.dev`.
## Docker install
If you wish, you can also provision the project with docker. This come with a few advantages:
You can also provision the project with Docker. This comes with a few advantages:
- It provides the exact same environment as our core developer team.
- It includes some additional dependencies (such as `playwright`) that you might need if you wish to contribute to some advanced areas of the project.
- It provisions a postgres database.
- It provisions a PostgreSQL database.
### 1. Pre-requisites
Make sure you have the latest `Docker` and [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) versions installed on your computer.
You can run `docker --version` to check they it is installed.
You can run `docker --version` to verify the installation.
### 2. Git clone
```
```bash
git clone git@github.com:twentyhq/twenty.git
```
### 3. Setup env variables
Twenty requires a few environment variables to be set. Locally, we recommend setting them through `.env` pattern.
```
Twenty requires a few environment variables to be set. Locally, we recommend setting them through `.env` files.
```bash
cp ./front/.env.example ./front/.env
cp ./server/.env.example ./server/.env
```
@@ -123,60 +123,61 @@ The default values should work out of the box.
### 4. Build
We provide a containerized environment with Docker and orchestrated with docker-compose.
This install will also provision a Postgres container.
We provide an environment containerized with Docker and orchestrated with `docker-compose`.
This installation method will also provision a PostgreSQL container.
**Note:** the configuration is stored `infra/dev` folder but you can run `make` commands direclty from the root folder.
**Note:** 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
```
### 5. Migrate & seed
Before running the project, you need to initialize the database by running migration and seeds.
Before running the project, you need to initialize the database by running the migrations and seed.
Start the containers:
```
```bash
make up
```
Run database migrations, generate prisma client and seed:
```
Run database migrations, generate prisma client, and seed:
```bash
make server-prisma-reset
```
### 6. Start Twenty
Once this is completed you can run the project with the following commands:
Run the project with the following commands:
front:
```
In `/front`:
```bash
make front-start
```
server:
```
In `/server`:
```bash
make server-start
```
- front available on: [http://localhost:3001](http://localhost:3001)
- server available on: [http://localhost:3000/graphql](http://localhost:3000/graphql)
- postgres: available on [http://localhost:5432](http://localhost:5432) and should contain database named `default`
You should now have:
- **front** available on: [http://localhost:3001](http://localhost:3001)
- **server** available on: [http://localhost:3000/graphql](http://localhost:3000/graphql)
- **postgres** available on [http://localhost:5432](http://localhost:5432) and containing database named `default`
### 7. Sign in to your local Twenty installation
Browse [http://localhost:3001](http://localhost:3001). You can connect using our recently seeded demo account `tim@apple.dev`.
Open [http://localhost:3001](http://localhost:3001) and sign in using our seeded demo account `tim@apple.dev`.
### 8. (Optional)
If you don't want to use make command and work directly from the container, you can also ssh directly in the container
If you don't want to use the `make` command and work directly from the container, you can also ssh directly into the container:
```
```bash
make sh
```
Then run commands through yarn:
```
```bash
cd server
yarn prisma:reset
```
docs/docs/developer/workflows.mdx
+2 -2
View File
@@ -9,9 +9,9 @@ sidebar_custom_props:
If you are using VSCode, we provide a [.vscode](https://github.com/twentyhq/twenty/tree/main/.vscode) configuration.
## Front development commands
## Frontend development commands
```
```bash
yarn # install dependencies
yarn start # start local development server