From 3b2db839dec35c95939a2cd90f3d32e7cc983afc Mon Sep 17 00:00:00 2001
From: Pia B <pia.bregulla@web.de>
Date: Fri, 7 Aug 2026 12:51:35 +0200
Subject: [PATCH 1/3] document server files requirements

---
 README.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..08f7949
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+### Adding a Server File
+
+The minimum valid Server File needs a `domain` and a `categories` field defined. The Filename has to match the `domain`
+here is an example:
+
+filename: `catland.meow.yaml`
+
+```
+---
+domain: catland.meow
+categories:
+- food
+- religion
+```
+A file with all possible fields set could look like this:
+
+filename: `some.server.yaml`
+
+```
+---
+domain: some.server
+categories: [general]
+legal_body_type: natural
+region: europe
+languages:
+- english
+- french
+description: on our server everyone is welcome, as long as you treat each other nicely and share pictures of your pets
+```
+
+### Schema definition
+you can also find the schema definition here: .schema.yml
+
+#### all fields explained:
+- `categories` is a list and can be any number of the following values:
+```
+- academia
+- activism
+- adult
+- art
+- books
+- food
+- furry
+- games
+- general
+- hobby
+- humor
+- journalism
+- lgbt
+- music
+- bipoc
+- regional
+- religion
+- sports
+- tech
+```
+
+further you can define
+- `legal_body_type` which can either be `natural` or `juridicial` 
+- `region` which can either be `europe`, `north_america`, `south_america`, `africa`, `asia` or `oceania`
+
+- `languages` and `description` are automatically pulled from the `languages` and `description` you have defined on your server, if you want to present your server with different `languages` or `description` you can define both here.
+This will override the automatically pulled values on our end. 
+`languages` is a list and can have multiple entries, possible values are not predefined.

From 160ed14f970deb9280458234312f19dbca05f5cc Mon Sep 17 00:00:00 2001
From: Pia B <pia.bregulla@web.de>
Date: Wed, 12 Aug 2026 13:38:28 +0200
Subject: [PATCH 2/3] add list of languages

---
 README.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 72 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 08f7949..4ae3ad8 100644
--- a/README.md
+++ b/README.md
@@ -23,8 +23,8 @@ categories: [general]
 legal_body_type: natural
 region: europe
 languages:
-- english
-- french
+- en
+- fr
 description: on our server everyone is welcome, as long as you treat each other nicely and share pictures of your pets
 ```
 
@@ -61,4 +61,73 @@ further you can define
 
 - `languages` and `description` are automatically pulled from the `languages` and `description` you have defined on your server, if you want to present your server with different `languages` or `description` you can define both here.
 This will override the automatically pulled values on our end. 
-`languages` is a list and can have multiple entries, possible values are not predefined.
+`languages` is a list and can have multiple values from the following list:
+```
+- ar
+- ast
+- bg
+- bn
+- br
+- ca
+- co
+- cs
+- cy
+- da
+- de
+- el
+- en
+- eo
+- es
+- et
+- eu
+- fa
+- fi
+- fr
+- ga
+- gl
+- he
+- hi
+- hr
+- hu
+- hy
+- id
+- io
+- is
+- it
+- ja
+- ka
+- kab
+- kk
+- kn
+- ko
+- lt
+- lv
+- mk
+- ml
+- mr
+- ms
+- nl
+- nn
+- no
+- oc
+- pl
+- pt
+- ro
+- ru
+- sk
+- sl
+- sq
+- sr
+- sv
+- szl
+- ta
+- tai
+- te
+- th
+- tr
+- ug
+- uk
+- ur
+- vi
+- zh
+```

From 10eab8b2af3805076ed11185d2ef5acb9f8b5df6 Mon Sep 17 00:00:00 2001
From: Pia B <pia.bregulla@web.de>
Date: Thu, 27 Aug 2026 09:27:13 +0200
Subject: [PATCH 3/3] change languages example

---
 README.md | 68 ++-----------------------------------------------------
 1 file changed, 2 insertions(+), 66 deletions(-)

diff --git a/README.md b/README.md
index 4ae3ad8..073c3e3 100644
--- a/README.md
+++ b/README.md
@@ -61,73 +61,9 @@ further you can define
 
 - `languages` and `description` are automatically pulled from the `languages` and `description` you have defined on your server, if you want to present your server with different `languages` or `description` you can define both here.
 This will override the automatically pulled values on our end. 
-`languages` is a list and can have multiple values from the following list:
+`languages` is a list and can have multiple entries, possible values are not predefined.
+example:
 ```
-- ar
-- ast
-- bg
-- bn
-- br
-- ca
-- co
-- cs
-- cy
-- da
-- de
-- el
 - en
-- eo
-- es
-- et
-- eu
-- fa
-- fi
 - fr
-- ga
-- gl
-- he
-- hi
-- hr
-- hu
-- hy
-- id
-- io
-- is
-- it
-- ja
-- ka
-- kab
-- kk
-- kn
-- ko
-- lt
-- lv
-- mk
-- ml
-- mr
-- ms
-- nl
-- nn
-- no
-- oc
-- pl
-- pt
-- ro
-- ru
-- sk
-- sl
-- sq
-- sr
-- sv
-- szl
-- ta
-- tai
-- te
-- th
-- tr
-- ug
-- uk
-- ur
-- vi
-- zh
 ```