refactor(kb/postgres): group related articles into a dedicated folder

knowledge base/mysql.md

@@ -51,7 +51,7 @@ grant ALL on db.* to 'username'@'127.0.0.1';
   -->
 
 <!-- Knowledge base -->
-[postgresql]: postgresql.md
+[postgresql]: postgresql/README.md
 [sql]: sql.md
 
 <!-- Others -->

knowledge base/percona toolkit.md

@@ -1,5 +1,6 @@
 # Percona toolkit
 
+> [!caution]
 > TODO
 
 Intro
@@ -47,6 +48,8 @@ Intro
 
 - [Website]
 - [Codebase]
+- [MySQL]
+- [PostgreSQL]
 
 ### Sources
 
@@ -59,6 +62,9 @@ Intro
 
 <!-- In-article sections -->
 <!-- Knowledge base -->
+[MySQL]: mysql.md
+[PostgreSQL]: postgresql/README.md
+
 <!-- Files -->
 <!-- Upstream -->
 [Codebase]: https://github.com/percona/percona-toolkit

knowledge base/postgresql/README.md

@@ -383,21 +383,21 @@ See also [yugabyte/yugabyte-db].
   -->
 
 <!-- Knowledge base -->
-[mysql]: mysql.md
-[Percona toolkit]: percona%20toolkit.md
+[mysql]: ../mysql.md
+[Percona toolkit]: ../percona%20toolkit.md
+[pg_dump]: pg_dump.md
+[pg_dumpall]: pg_dumpall.md
 [pg_flo]: pg_flo.md
+[pg_restore]: pg_restore.md
 [pgadmin]: pgadmin.md
 [pgBackRest]: pgbackrest.md
-[sql]: sql.md
+[sql]: ../sql.md
 
 <!-- Upstream -->
 [create function]: https://www.postgresql.org/docs/current/sql-createfunction.html
 [database connection control functions]: https://www.postgresql.org/docs/current/libpq-connect.html
 [docker image]: https://github.com/docker-library/docs/blob/master/postgres/README.md
 [logical decoding concepts]: https://www.postgresql.org/docs/current/logicaldecoding-explanation.html
-[pg_dump]: https://www.postgresql.org/docs/current/app-pgdump.html
-[pg_dumpall]: https://www.postgresql.org/docs/current/app-pg-dumpall.html
-[pg_restore]: https://www.postgresql.org/docs/current/app-pgrestore.html
 [pg_settings]: https://www.postgresql.org/docs/current/view-pg-settings.html
 [psql]: https://www.postgresql.org/docs/current/app-psql.html
 [the password file]: https://www.postgresql.org/docs/current/libpq-pgpass.html
@@ -422,6 +422,6 @@ See also [yugabyte/yugabyte-db].
 [postgresql_anonymizer]: https://postgresql-anonymizer.readthedocs.io/en/stable/
 [postgresql: get member roles and permissions]: https://www.cybertec-postgresql.com/en/postgresql-get-member-roles-and-permissions/
 [postgresql: show all the privileges for a concrete user]: https://stackoverflow.com/questions/40759177/postgresql-show-all-the-privileges-for-a-concrete-user
+[what does grant usage on schema do exactly?]: https://stackoverflow.com/questions/17338621/what-does-grant-usage-on-schema-do-exactly
 [what is the pg_dump command for backing up a postgresql database?]: https://www.linkedin.com/advice/3/what-pgdump-command-backing-up-postgresql-ke2ef
 [yugabyte/yugabyte-db]: https://github.com/yugabyte/yugabyte-db
-[what does grant usage on schema do exactly?]: https://stackoverflow.com/questions/17338621/what-does-grant-usage-on-schema-do-exactly

knowledge base/postgresql/pg_dump.md

@@ -0,0 +1,74 @@
+# pg_dump
+
+> [!caution]
+> TODO
+
+Intro
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Setup</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [PostgreSQL]
+- [pg_dumpall]
+- [pg_restore]
+
+### Sources
+
+- [Documentation]
+- [A Complete Guide to pg_dump With Examples, Tips, and Tricks]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[pg_dumpall]: pg_dumpall.md
+[pg_restore]: pg_restore.md
+[PostgreSQL]: README.md
+
+<!-- Files -->
+<!-- Upstream -->
+[Documentation]: https://www.postgresql.org/docs/current/app-pgdump.html
+
+<!-- Others -->
+[A Complete Guide to pg_dump With Examples, Tips, and Tricks]: https://www.dbvis.com/thetable/a-complete-guide-to-pg-dump-with-examples-tips-and-tricks/

knowledge base/postgresql/pg_dumpall.md

@@ -0,0 +1,72 @@
+# pg_dumpall
+
+> [!caution]
+> TODO
+
+Intro
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Setup</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [PostgreSQL]
+- [pg_dump]
+- [pg_restore]
+
+### Sources
+
+- [Documentation]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[pg_dump]: pg_dump.md
+[pg_restore]: pg_restore.md
+[PostgreSQL]: README.md
+
+<!-- Files -->
+<!-- Upstream -->
+[Documentation]: https://www.postgresql.org/docs/current/app-pg-dumpall.html
+
+<!-- Others -->

knowledge base/postgresql/pg_flo.md

@@ -188,6 +188,7 @@ Periodic status updates are sent to the source DB to maintain the replication's
 
 ## Further readings
 
+- [PostgreSQL]
 - [Website]
 - [Main repository]
 - [Transformation rules]
@@ -206,7 +207,8 @@ Periodic status updates are sent to the source DB to maintain the replication's
 
 <!-- In-article sections -->
 <!-- Knowledge base -->
-[nats]: nats.md
+[NATS]: ../nats.md
+[PostgreSQL]: README.md
 
 <!-- Files -->
 <!-- Upstream -->

knowledge base/postgresql/pg_restore.md

@@ -0,0 +1,72 @@
+# pg_restore
+
+> [!caution]
+> TODO
+
+Intro
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Setup</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+
+```sh
+```
+
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+
+```sh
+```
+
+</details>
+-->
+
+## Further readings
+
+- [PostgreSQL]
+- [pg_dump]
+- [pg_dumpall]
+
+### Sources
+
+- [Documentation]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[pg_dump]: pg_dump.md
+[pg_dumpall]: pg_dumpall.md
+[PostgreSQL]: README.md
+
+<!-- Files -->
+<!-- Upstream -->
+[Documentation]: https://www.postgresql.org/docs/current/app-pgrestore.html
+
+<!-- Others -->

knowledge base/postgresql/pgadmin.md

@@ -40,9 +40,9 @@ docker pull 'dpage/pgadmin4'
 
 ## Further readings
 
+- [PostgreSQL]
 - [Website]
 - [Codebase]
-- [PostgreSQL]
 
 ### Sources
 
@@ -55,7 +55,7 @@ docker pull 'dpage/pgadmin4'
 
 <!-- In-article sections -->
 <!-- Knowledge base -->
-[postgresql]: postgresql.md
+[PostgreSQL]: README.md
 
 <!-- Files -->
 <!-- Upstream -->

knowledge base/postgresql/pganalyze collector.md

@@ -24,7 +24,8 @@ vim '/etc/pganalyze-collector.conf' && pganalyze-collector --test --reload \
 
 ## Further readings
 
-- [Main repository]
+- [PostgreSQL]
+- [Codebase]
 - [Documentation]
 
 ### Sources
@@ -36,9 +37,11 @@ vim '/etc/pganalyze-collector.conf' && pganalyze-collector --test --reload \
 
 <!-- In-article sections -->
 <!-- Knowledge base -->
+[PostgreSQL]: README.md
+
 <!-- Files -->
 <!-- Upstream -->
-[documentation]: https://pganalyze.com/docs/collector/
-[main repository]: https://github.com/pganalyze/collector
+[Codebase]: https://github.com/pganalyze/collector
+[Documentation]: https://pganalyze.com/docs/collector/
 
 <!-- Others -->

knowledge base/postgresql/pgbackrest.md

@@ -151,6 +151,7 @@ pgbackrest … --stanza 'prod-app' stanza-create
 
 ## Further readings
 
+- [PostgreSQL]
 - [Website]
 - [Codebase]
 
@@ -166,6 +167,8 @@ pgbackrest … --stanza 'prod-app' stanza-create
 
 <!-- In-article sections -->
 <!-- Knowledge base -->
+[PostgreSQL]: README.md
+
 <!-- Files -->
 <!-- Upstream -->
 [Codebase]: https://github.com/pgbackrest/pgbackrest

knowledge base/sql.md

@@ -34,7 +34,7 @@ They reference either the primary key or another `UNIQUE` constraint of the refe
 <!-- In-article sections -->
 <!-- Knowledge base -->
 [mysql]: mysql.md
-[postgresql]: postgresql.md
+[postgresql]: postgresql/README.md
 
 <!-- Files -->
 <!-- Upstream -->