Skip to content

Commit 068adba

Browse files
committed
feat(docs): proof read articles
1 parent 6a06462 commit 068adba

22 files changed

+232
-225
lines changed

docs/architecture/api.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: APIs
3-
description: At its core, LogChimp is powered by RESTful JSON API.
3+
description: LogChimp's foundation lies in its powerfull RESTful JSON API.
44
slug: /docs/architecture/api
55
---
66

7-
At its core, LogChimp is a RESTful JSON API - designed to track, manage, engage, and analyze user feedback with ease.
7+
LogChimp's foundation lies in its RESTful JSON API, designed to effortlessly track, manage, engage, and analyze user feedback.
88

9-
To know more about [LogChimp APIs](/api).
9+
To learn more about [LogChimp APIs](/api).
1010

1111
### Versioning
1212

13-
Each major version of LogChimp ships with multiple versions of the APIs. We maintain a stable APIs so that you can be sure about depending on them in production.
13+
Each major version of LogChimp ships with multiple versions of the APIs. We maintain stable APIs so that you can confidently depend on them in production.

docs/architecture/readme.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,25 @@
11
---
22
title: Architecture
3-
description: How LogChimp works with it's architecture?
3+
description: Understanding LogChimp's architecture
44
slug: /docs/architecture
55
---
66

7-
LogChimp is an independent, built on a modern technology stack of Node.js for powering its robust JSON API, stand-alone system with dependency only on the database (PostgreSQL) as a data storage layer, with a beautiful and rich client app written in Vue.js including a powerful dashboard - find out more.
7+
LogChimp is an independent system built on a modern technology stack. It utilizes Node.js to power its robust JSON API and relies solely on the PostgreSQL database as its data storage layer. Complemented by a beautifully crafted client app written in Vue.js with Typescript, LogChimp offers a powerful dashboard, providing users with a comprehensive experience.
88

9-
A high-level view of LogChimp's architecture is as shown:
9+
A high-level overview of LogChimp's architecture is shown below:
1010

1111
![LogChimp Architecture](../../images/docs/architecture/architecture.png)
1212

13-
These five areas work together to make every LogChimp site function smoothly.
13+
These five components work together seamlessly to ensure the smooth functioning of every LogChimp site:
1414

1515
1. [Robust REST APIs](/docs/architecture/api)
1616
2. Beautiful Vue.js client app
1717
3. Powerful Dashboard
1818
4. PostgreSQL Database
1919
5. Disk storage space
2020

21-
## Node environment
21+
## Node Environment
2222

23-
LogChimp supports three environments: `development`, `testing`, `production`. A public LogChimp site should always run in **production** mode, development is used for building LogChimp locally and testing is only used in CI/CD to run tests.
23+
LogChimp supports three environments: `development`, `testing`, and `production`.
24+
25+
Public LogChimp sites should always run in **production** mode, while the `development` environment is used for the local development of LogChimp. The `testing` environment is exclusively employed in CI/CD pipelines for running tests.

docs/cli/commands.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
22
title: Commands
3-
description: Below are the available LogChimp CLI commands. You can always run `logchimp --help` or `logchimp help [COMMAND]` to get more detail.
3+
description: Explore the available LogChimp CLI commands below. For detailed information on each command, you can always run `logchimp --help` or `logchimp help [COMMAND]`.
44
slug: /docs/cli/commands
55
---
66

77
import { Alert } from "../../../src/components/Documentation/Alert.tsx"
88

99
<Alert type="tip">
10-
Each command is documented in detail on its own page.
10+
Each command is thoroughly documented on its own page.
1111
</Alert>
1212

1313
- [logchimp help](/docs/cli/help)
1414

1515
### Config
1616

17-
Command for managing logchimp configuration.
17+
Commands for managing LogChimp configuration.
1818

1919
- [logchimp config](/docs/cli/config)
2020
- [logchimp config:generate](/docs/cli/config/generate)

docs/cli/config/generate.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,35 +10,34 @@ USAGE
1010

1111
EXAMPLES
1212
$ logchimp config:generate --force
13-
$ logchimp config:generate --dbhost=localhost --dbuser=username
14-
--dbname=database --dbport=5432
13+
$ logchimp config:generate --dbhost=localhost --dbuser=username --dbname=database --dbport=5432
1514
```
1615

1716
### Options
1817

19-
- `-f` or `--force` - Overwrite the existing configuration file, if present.
18+
- `-f` or `--force` - Overwrite the existing configuration file if present
2019
- `-i` or `--interactive` - Use interactive mode
21-
- `--env` - Generates `logchimp.config.json` file using environment variable.
20+
- `--env` - Generate a `logchimp.config.json` file using environment variables
2221

2322
**Server**
2423

2524
- `--local` - Run LogChimp for local development/testing
2625
- `--port=port` - [default: 3000] Server port to listen on
27-
- `--secretKey=secretKey` - Secret key for password validation _(default auto generate random string)_
26+
- `--secretKey=secretKey` - Secret key for password validation _(default auto-generates a random string)_
2827

2928
**Database**
3029

3130
- `--dbhost=dbhost` - Database host
3231
- `--dbname=dbname` - Database name
33-
- `--dbpass=dbpass` - Database password _(default auto generate random password)_
32+
- `--dbpass=dbpass` - Database password _(default auto-generates a random password)_
3433
- `--dbport=dbport` - [default: 5432] Database port
35-
- `--[no-]dbssl` - Enable SSL for database _(default true for production)_
34+
- `--[no-]dbssl` - Enable SSL for the database _(default true for production)_
3635
- `--dbuser=dbuser` - Database username
3736

3837
**Mail**
3938

4039
- `--mailhost=mailhost` - Mail service SMTP hostname
41-
- `--mailpass=mailpass` - Mail service SMTP password _(default auto generate random password)_
40+
- `--mailpass=mailpass` - Mail service SMTP password _(default auto-generates a random password)_
4241
- `--mailport=mailport` - [default: 587] Mail service SMTP port
43-
- `--mailservice=mailservice` - Mail service e.g. MailGun
42+
- `--mailservice=mailservice` - Mail service e.g., MailGun
4443
- `--mailuser=mailuser` - Mail service SMTP username

docs/cli/config/get.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: logchimp config:get
3-
description: Get a specific value from the configuration file.
3+
description: Retrieve a specific value from the configuration file.
44
slug: /docs/cli/config/get
55
---
66

@@ -9,10 +9,10 @@ USAGE
99
$ logchimp config:get [flags]
1010

1111
EXAMPLES
12-
$ logchimp config:get --key database.port
13-
$ logchimp config:get --key server.secretKey
12+
$ logchimp config:get --key=database.port
13+
$ logchimp config:get --key=server.secretKey
1414
```
1515

1616
### Options
1717

18-
- `-k` or `--key=key` - key of which you want to get the value
18+
- `-k` or `--key=key` - Key for retrieving the value

docs/cli/config/readme.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: logchimp config
3-
description: Generate or modify the LogChimp configuration using `config` command.
3+
description: Generate or modify LogChimp configuration using the `config` command.
44
slug: /docs/cli/config
55
---
66

7-
The `config` commands contains multiple sub-commands.
7+
The `config` command contains multiple sub-commands.
88

99
```bash
1010
USAGE

docs/cli/config/set.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,5 +11,5 @@ USAGE
1111

1212
### Options
1313

14-
- `-k` or `--key=key` - name to print
15-
- `-v` or `--value=value` - name to print
14+
- `-k` or `--key=key` - Key to set in the configuration file
15+
- `-v` or `--value=value` - Value to set in the configuration file

docs/cli/help.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: logchimp help
3-
description: Use the help command to access the list of possible `logchimp` commands when required.
3+
description: Use the help command to access the list of possible `logchimp` commands when needed.
44
slug: /docs/cli/help
55
---
66

7-
This command is your port of call when you want to discover a list of available commands in the LogChimp CLI.
7+
This command is your go-to when you want to discover a list of available commands in the LogChimp CLI.
88

99
```bash
1010
CLI Tool for LogChimp

docs/cli/readme.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
title: CLI
3-
description: An all-in-one tool to help you configure and making it super easy to spin up a new LogChimp site.
3+
description: An all-in-one tool to help you configure and make it super easy to spin up a new LogChimp site.
44
slug: /docs/cli
55
---
66

7-
We understand that some users are going to want more flexibility, so the CLI has a whole set of flags and options that allow you to break the steps down and adjust what they do.
7+
We understand that some users are going to want more flexibility, so the CLI has a whole set of flags and options that allow you to break down the steps and adjust what they do.
88

99
If you have any suggestions or find bugs 🐞, head over to the [LogChimp CLI GitHub repository](https://github.com/logchimp/logchimp-cli) and let us know.
1010

1111
## Install
1212

13-
LogChimp CLI is an npm package that can be installed via either npm or yarn.
13+
LogChimp CLI is an npm package that can be installed via either npm or yarn or pnpm.
1414

1515
```bash
1616
npm install -g logchimp-cli

docs/config.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
11
---
22
title: Configuration
3-
description: Step by step guide for you to configure LogChimp site using `logchimp.config.json` file.
3+
description: Step-by-step guide for configuring LogChimp site using `logchimp.config.json` file.
44
slug: /docs/config
55
---
66

77
import { Alert } from "../../src/components/Documentation/Alert.tsx"
88

99
## Overview
1010

11-
There are some configuration options which is pre-filled by default at installation process via [one-click deploy](/docs/install) button, and other options needs to be configured manually, _for example secret credentials_.
11+
Some configuration options are pre-filled by default during the installation process via the [one-click deploy](/docs/install) button, while others need to be configured manually, such as secret credentials.
1212

1313
There are two ways to configure your LogChimp site:
1414

15-
1. `logchimp.config.json` file
16-
2. Environment variables
15+
1. Using the `logchimp.config.json` file
16+
2. Using environment variables
1717

1818
<Alert type="tip">
19-
Configuring your LogChimp site is one time task and is not required for you to update often, unless you're rotating your secret credentials.
19+
Configuring your LogChimp site is a one-time task and is not required to be updated frequently, unless you're rotating your secret credentials.
2020
</Alert>
2121

2222
## `logchimp.config.json` file
2323

2424
A custom configuration file must be a valid JSON file located in the root folder.
2525

2626
<Alert type="warning">
27-
The configuration below is just an example and not recommended for production use.
27+
The configuration below is just an example and is not recommended for production use.
2828
</Alert>
2929

30-
The two required options are `database` and `server` which are configurated during installation process.
30+
The two required options are `database` and `server`, which are configured during the installation process.
3131

3232
```json lines
3333
{
@@ -49,7 +49,7 @@ The two required options are `database` and `server` which are configurated duri
4949

5050
### Mail
5151

52-
LogChimp uses SMPT connection for sending emails programmatically.
52+
LogChimp uses SMTP connection for sending emails programmatically.
5353

5454
```json lines
5555
{
@@ -64,34 +64,34 @@ LogChimp uses SMPT connection for sending emails programmatically.
6464
}
6565
```
6666

67-
## Environment variables
67+
## Environment Variables
6868

6969
**SERVER**
7070

71-
- `LOGCHIMP_SECRET_KEY`: Railway provides an easy way to generate 32-char secret key, by pressing `Command + K` (on MacOS) or `Ctrl + K` (on windows). Of course, you can provide your own secret key as well.
71+
- `LOGCHIMP_SECRET_KEY`: Railway provides an easy way to generate a 32-character secret key by pressing `Command + K` (on MacOS) or `Ctrl + K` (on Windows). Of course, you can provide your own secret key as well.
7272
- `PORT`: Please do not change the pre-filled value.
73-
- `LOGCHIMP`: This tells LogChimp to use environment variables instead of [configuration file](/docs/config). Please do not change the pre-filled value.
74-
- `LOGCHIMP_THEME_STANDALONE`: LogChimp allows you to run on single port or split API and theme. If you're using Railway deploy button, you can leave the value to `false`.
73+
- `LOGCHIMP`: This tells LogChimp to use environment variables instead of a [configuration file](/docs/config). Please do not change the pre-filled value.
74+
- `LOGCHIMP_THEME_STANDALONE`: LogChimp allows you to run on a single port or split API and theme. If you're using the Railway deploy button, you can leave the value as `false`.
7575

7676
**DATABASE**
7777

78-
You can use your own PostgreSQL database or use PostgreSQL plugin provided by Railway. If you're using Railway plugin, you don't have to change the pre-filled values.
78+
You can use your own PostgreSQL database or use the PostgreSQL plugin provided by Railway. If you're using the Railway database, you don't have to change the pre-filled values.
7979

80-
- `LOGCHIMP_DB_HOST`: Database host; default to `${{ PGHOST }}`
81-
- `LOGCHIMP_DB_DATABASE`: Database name; default to `${{ PGDATABASE }}`
82-
- `LOGCHIMP_DB_PORT`: Database port; default to `${{ PGPORT }}`
83-
- `LOGCHIMP_DB_USER`: Database user; default to `${{ PGUSER }}`
84-
- `LOGCHIMP_DB_PASSWORD`: Database password; default to `${{ PGPASSWORD }}`
85-
- `LOGCHIMP_DB_SSL`: Database SSL; default to `true`
80+
- `LOGCHIMP_DB_HOST`: Database host; defaults to `${{ PGHOST }}`
81+
- `LOGCHIMP_DB_DATABASE`: Database name; defaults to `${{ PGDATABASE }}`
82+
- `LOGCHIMP_DB_PORT`: Database port; defaults to `${{ PGPORT }}`
83+
- `LOGCHIMP_DB_USER`: Database user; defaults to `${{ PGUSER }}`
84+
- `LOGCHIMP_DB_PASSWORD`: Database password; defaults to `${{ PGPASSWORD }}`
85+
- `LOGCHIMP_DB_SSL`: Database SSL; defaults to `true`
8686

8787
**MAIL**
8888

89-
You've have to provide SMPT mail authentication details.
89+
You have to provide SMTP mail authentication details.
9090

9191
- `LOGCHIMP_MAIL_SERVICE`: Name of the email service provider
9292
- `LOGCHIMP_MAIL_HOST`, `LOGCHIMP_MAIL_USER`, and `LOGCHIMP_MAIL_PASSWORD`
93-
- `LOGCHIMP_MAIL_PORT`: SMPT port provided by the service provider; default to `587`
93+
- `LOGCHIMP_MAIL_PORT`: SMTP port provided by the service provider; defaults to `587`
9494

95-
**Does LogChimp support SMPT connection URL?**
95+
**Does LogChimp support SMTP connection URL?**
9696

9797
No, currently it's not supported. But you're most welcome to [submit a feature request](https://github.com/logchimp/logchimp) anytime.

0 commit comments

Comments
 (0)