clarify doc

README.md

@@ -3,7 +3,30 @@
 You are here on the tech side, to understand under the wood how it works and how you can contribute to this tech journey.
 See [apXtrib web site](https://apxtrib.crabdance.com) how to create a new social world with apXtrib.
 
-## apXtrib Architecture a quick view & keywords definition
+Tool to create online infrastructure (like websites chats, etc...) that are:
+- censorship resilient
+- community friendly due to a common rule set to avoid abuses
+- hostless: neither self-hosted, nor cloud hosted. Only hosted by the users.
+- immutable: a website/chat/etc... service could not be modified... No possibility to be bought by microsoft ;)
+
+## apXtri Architecture
+
+Each user has an unique identification create by anyone based on PGP (public/Private key) and an alias (humanly understandable) that allow a member to proof that he owns data. Can be anonymous but all his actions are store into a blockchain of reputation.
+
+He could join a community to communicate with these people. (We sometimes unformally call this community a `tribe` for fun).
+
+One of the user of each community could become a `moderator` to apply the rules of the `tribe`
+
+User could "mine" `the XTRIB coin` to host.
+
+We are currently debating if the user could also mine the network to ensure security or if he should not as we could be using a p2p consensus `proof of trust` to minimize the data.
+
+We are also debating if the netwrok must be accessible online by minner of if we should not use a `small world network` consensus to minimize mining cost.
+
+
+## deprecated: apXtrib Architecture a quick view & keywords definition
+
+There used to be some keyword that used to have a specific definition in apxtri. In 2025, it has been decided to have a more explicit terminology based on words not apxtri related. The next typology is deprecated. It could still (but we do not hope) be present in the developper discussion.
 
 - **a nation** is a topology network of nodes town that share the same fundamental rules (engrave into a common blockchain). 
 - **a town** is a physical installation node of a machine (linux server) plug into a LAN network (a telecom box NAT conf) accessible into internet a WAN network (domain name redirect to a town public IP).