[noci] sucksless brief words

README.md

@@ -1,12 +1,44 @@
-# fuho core blog engine
+# wagtail - the singing cms
 
-powered by `wagtail`. awesome!
+A pretty simple `wagtail` setup for simple kind of JUST BLOGGING, and scaling under docker.
 
-## run this
+## Server
 
-1. `pip install -r requirements.txt` (classic snake yapping)
-2. read `run.sh` pls
+### Install
 
-## client
+- You may find yourself struggle with snake-engine. Don't worry, because Docker shipment is supported.
+  > Run the container (testing purpose)
+  >
+  > ```sh
+  > docker run ghcr.io/team-fuho/wt:main -p 8000:8000
+  > ```
+  >
+  > To run in production with non emphemeral storage, here is the required entry that you need to bind on.
+  >
+  > - If there is no `DATABASE_URL` defined, it will rely on `/app/db.sqlite3`
+  > - also if there is no [django-storage](https://django-storages.readthedocs.io/en/latest/) env defined correctly, it uses `/app/media`
+  >   Configure properly
+  > - `DATABASE_URL` is recommended. parsed by [dj-database-url](https://pypi.org/project/dj-database-url/)
+- Though, for a portable setup, I recommend
+  > ```sh
+  > uv venv
+  > ./.venv/Scripts/activate # on windows
+  > ./.venv/bin/activate # on *nix
+  > uv sync
+  > python ./manage.py createsuperuser # wagtail initial setup (to add admin)
+  > python ./manage.py runserver # wagtail default behaviour
+  > ```
 
-recently, 2.0.0 migrated to graphql compatible system and whatever
+## Client
+
+### V2
+
+Migrated to GraphQL query system
+
+> [!NOTE]
+> As to avoid redirection that cause performance issue at scale, I won't enable trail-slash redirection. The graphql endpoint would be: `http://host/api/graphql/` (notice the trailing slash)
+
+### V1
+
+> [!IMPORTANT]
+> Deprecated