chore: clarifications, doc

Signed-off-by: Jaime Silvela <jaime.silvela@enterprisedb.com>

Author: jsilvela

content/end_users/README.md

@@ -0,0 +1,31 @@
+---
+build:
+  list: never
+  publishResources: false
+  render: never
+---
+
+# End Users section order
+
+Each Markdown entry in the `end_users` directory (except this README file)
+should have a `weight` in the Hugo preamble, like so:
+
+``` txt
+---
+title: Shinkansen
+image: logo/shinkansen.png
+homepage: https://shinkansen.finance/
+weight: 44
+---
+```
+
+The weight should be computed so that entries are displayed in the End Users
+page in chronological order, the oldest entries at the top.
+
+The entries in this directory are based in the CNPG [ADOPTERS.md](https://github.com/cloudnative-pg/cloudnative-pg/blob/e5ef2fdaccd2c8fbdbf319f1224a0f90bbcfed30/ADOPTERS.md)
+file.
+To ensure the weights of end-users don't need modification as more and more are
+added, we should use as `weight` of an end user, the line it appears in, in the
+ADOPTERS file.
+
+E.g. Shinkansen is in line 44, whereas EDB is in line 34.

content/end_users/biganimal.md

@@ -2,6 +2,7 @@
 title: BigAnimal
 image: logo/biganimal.svg
 homepage: https://biganimal.com
+weight: 34
 ---
 
 BigAnimal is a fully managed database-as-a-service with built-in Oracle

content/end_users/shinkansen.md

@@ -2,6 +2,7 @@
 title: Shinkansen
 image: logo/shinkansen.png
 homepage: https://shinkansen.finance/
+weight: 44
 ---
 
 Shinkansen moves your money at the speed of the internet