Skip to content

Commit 646c0a3

Browse files
committed
Merge branch 'cleanup/docs-readme-polish' into 'master'
docs: fix typos and Markdown formatting across project docs Closes #714 See merge request postgres-ai/database-lab!1149
2 parents 4dcf46c + 1836ff8 commit 646c0a3

6 files changed

Lines changed: 12 additions & 14 deletions

File tree

CODE_OF_CONDUCT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ the community.
114114

115115
## Attribution
116116

117-
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
117+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118118
version 2.1, available at [v2.1].
119119

120120
Community Impact Guidelines were inspired by [Mozilla CoC].

CONTRIBUTING.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ Consistent messaging is important throughout the codebase. Follow these guidelin
133133

134134
#### CLI output
135135
- Use concise, action-oriented language
136-
- Present tense with ellipsis for in-progress actions: `Creating clone...`
136+
- Present tense with ellipsis for in-progress actions: `Creating clone...`
137137
- Ellipsis (`...`) indicates an ongoing process where the user should wait
138138
- Always follow up with a completion message when the operation finishes
139139
- Past tense with period for results: `Clone created successfully.`
@@ -166,7 +166,7 @@ Documentation for Database Lab Engine and additional components is hosted at htt
166166
We're building documentation following the principles described at https://documentation.divio.com/:
167167

168168
> There is a secret that needs to be understood in order to write good software documentation: there isn’t one thing called documentation, there are four.
169-
>
169+
>
170170
> They are: tutorials, how-to guides, technical reference and explanation. They represent four different purposes or functions, and require four different approaches to their creation. Understanding the implications of this will help improve most documentation - often immensely.
171171
172172
Learn more: https://documentation.divio.com/.
@@ -194,7 +194,7 @@ Postman collection is generated based on the OpenAPI spec file, using [Portman](
194194
##### Setup and Generation
195195
1. Install Portman: `npm install -g @apideck/portman`
196196
2. Generate Postman collection file:
197-
```
197+
```bash
198198
portman --cliOptionsFile engine/api/postman/portman-cli.json
199199
```
200200

@@ -207,7 +207,7 @@ Postman collection is generated based on the OpenAPI spec file, using [Portman](
207207

208208
##### CI/CD Integration
209209
The Postman collection is automatically run in CI/CD pipelines using Newman. For local testing:
210-
```
210+
```bash
211211
newman run engine/api/postman/dblab_api.postman_collection.json -e engine/api/postman/branching.aws.postgres.ai.postman_environment.json
212212
```
213213

README.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
<div align="center">
1717
<strong>⚡ Blazing-fast PostgreSQL cloning and branching 🐘</strong><br /><br />
1818
🛠️ Build powerful dev/test environments.<br />
19-
🔃 Cover 100% of DB migrations with CI tests.<br>
19+
🔃 Cover 100% of DB migrations with CI tests.<br />
2020
💡 Quickly verify ChatGPT ideas to get rid of hallucinations.<br /><br />
2121
Available for any PostgreSQL, including self-managed and managed services<sup>*</sup> like AWS RDS, GCP Cloud SQL, Supabase, and Timescale.<br /><br />
2222
It can be installed and used anywhere: across all cloud environments and on-premises.
@@ -204,15 +204,13 @@ Many thanks to our amazing contributors!
204204
</a>
205205

206206
## Translations
207-
Making DBLab more accessible to engineers around the globe is a great help for the project. Check details in the [translation section of contributing guide](./CONTRIBUTING.md#Translation).
207+
Making DBLab more accessible to engineers around the globe is a great help for the project. Check details in the [translation section of contributing guide](./CONTRIBUTING.md#translation).
208208

209209
This README is available in the following translations:
210210
- [German / Deutsch](translations/README.german.md) (by [@ane4ka](https://github.com/ane4ka))
211211
- [Brazilian Portuguese / Português (BR)](translations/README.portuguese-br.md) (by [@Alexand](https://gitlab.com/Alexand))
212-
- [Russian / Pусский](translations/README.russian.md) (by [@Tanya301](https://github.com/Tanya301))
212+
- [Russian / Русский](translations/README.russian.md) (by [@Tanya301](https://github.com/Tanya301))
213213
- [Spanish / Español](translations/README.spanish.md) (by [@asotolongo](https://gitlab.com/asotolongo))
214214
- [Ukrainian / Українська](translations/README.ukrainian.md) (by [@denis-boost](https://github.com/denis-boost))
215215

216216
👉 [How to make a translation contribution](./CONTRIBUTING.md#translation)
217-
218-

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ To report a security issue, please email us at security@postgres.ai with all the
1616
- Your issue is not security related.
1717

1818
## Security Vulnerability Response
19-
Each report is acknowledged and analyzed by the project's maintainers and the security team within 3 working days.
19+
Each report is acknowledged and analyzed by the project's maintainers and the security team within 3 working days.
2020

2121
The reporter will be kept updated at every stage of the issue's analysis and resolution (triage -> fix -> release).
2222

engine/api/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ We use ReadMe.io to host the API documentation: https://dblab.readme.io/. Once a
1515
The Postman collection is generated from the OpenAPI spec file using [Portman](https://github.com/apideck-libraries/portman).
1616
1. Install and initialize `portman`.
1717
1. Generate a new version of the Postman collection:
18-
```
18+
```bash
1919
portman --cliOptionsFile engine/api/postman/portman-cli.json
2020
```
2121
1. Review and adjust the collection:
2222
- Ensure object creation occurs before its deletion and pass the new object's ID between requests (TODO: provide example).
2323
- Review and update tests as needed (TODO: details).
24-
1. Commit, push, and ensure Newman's CI/CD testing passes.
24+
1. Commit, push, and ensure Newman's CI/CD testing passes.

ui/packages/platform/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ For detailed information about UI development, please refer to the main [CONTRIB
99
### Start Development Server
1010
Specify REST API server URL with `REACT_APP_API_SERVER` environment variable.
1111

12-
```
12+
```bash
1313
npm install
1414
npm run build
1515
npm run start

0 commit comments

Comments
 (0)