docs: add first documentation archetype.

docs/daos.md

@@ -0,0 +1,9 @@
+---
+state: design # Nothing implemented yet, figuring out the best way to do it.
+---
+
+# DAOs
+Decentralized Autonomous Organizations are represented as a group of [Realm](./realm.md)s or/and [package](.)s that can manage decisions using the blockchain. We have several DAOs that will be in charge of:
+
+- [OP Values prize DAO](.): It will define the prize per VM Op.
+- [Evaluation DAO](evaluation-dao.md): It will be in charge of making [Proof of Contribution](.) works.

docs/evaluation-dao.md

@@ -0,0 +1,10 @@
+---
+state: design # Nothing implemented yet, figuring out the best way to do it.
+---
+
+# Evaluation DAO
+
+It is a smart contract framework for reviewing, measuring, and accepting contributions. It is not the consensus mechanism but rather a platform.
+
+It scales itself -> managed by its members; serving as an entry point to become a new member.
+V1 is currently being developed as a [GoR](.) (Game of Realms) task.

docs/gno.land.md

@@ -0,0 +1,3 @@
+# gno.land
+
+gno.land is a reference to all applications included in the ecosystem, from [Tendermint V2](./new-tendermint.md) to [Gnovm](./gnovm.md), also including [Gnoweb](./gnoweb.md) and others.

docs/gnode.md

@@ -0,0 +1,12 @@
+---
+state: design # Nothing implemented yet, figuring out the best way to do it.
+---
+
+# Gnodes
+
+Gnodes are interconnected [DAOs](./daos.md) for scaling and specialized communities. They enable secure collaboration and seamless integration, facilitating transparent ecosystem management at scale.
+
+Layers and overlays for different perspectives:
+- first layer: entities, people, and connections to projects and teams.
+- second layer: relationships between entities, burn rate, payments (the "basic income" layer)
+- third layer: conflicts of interest, ownership stakes (privacy-preserving)

docs/gnovm.md

@@ -0,0 +1,7 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# Gnovm
+
+Gnovm is in charge to run [Gno](.) code. It interprets directly the source code and parses it to an AST. After that, it emulates CPU instructions to execute the AST instead of executing it directly. It is able to store the state of a [Realm](./realm.md) and retrieve it on the next execution.

docs/gnoweb.md

@@ -0,0 +1,9 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# Gnoweb
+
+gnoweb is an application that can call a special method on a [realm](./realm.md) that returns markdown as the output. This can be used to create any kind of web interface, like social networks, blog systems, forums, or standard status pages.
+
+The method that it calls is `Render(string)`string` where the input string is a path, and the output string is markdown.

docs/ibc-protocol.md

@@ -0,0 +1,12 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# IBC Protocol
+
+The Inter-Blockchain Communication Protocol (IBC) allows independent blockchains to directly communicate and trade assets.
+
+- The Inter‐Blockchain Communication Protocol (IBC), an open‐source protocol for relaying messages between independently distributed ledgers, was created to connect independent blockchains.
+- IBC allows heterogeneous chains to trustlessly communicate with each other and exchange value, particularly tokens, which makes them interoperable.
+- A key feature of IBC is that the connected blockchains do not need to communicate with each other directly. Instead, they can send packets of information via dedicated channels using smart contracts to connect to the chains.
+- The Tendermint‐based decentralized exchange [Osmosis](https://www.coinbase.com/cloud/discover/protocol-guides/guide-to-osmosis) allows token holders to directly benefit from what IBC offers by enabling seamless swaps of tokens from different chains.

docs/new-tendermint.md

@@ -0,0 +1,7 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# New Tendermint
+
+Tendermint is a consensus algorithm based on the Byzantine-Fault Tolerance algorithm. In gno.land, it is in charge of replicating the Gno VM machine state among all the nodes on the network.

docs/realm-state.md

@@ -0,0 +1,11 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# Realm State
+
+State stores the state of a Realm. It stores all the Realm public variables as a Merkle tree.
+
+## Format
+
+TODO

docs/realm.md

@@ -0,0 +1,9 @@
+---
+state: improvements-needed # The final PoC is working well, but it must evolve performance-wise.
+---
+
+# Realm
+
+A realm is the equivalent of a smart contract. It is a program that cannot be powered off.
+
+All public methods of a Realm can be accessed by anyone, and all the global variables will be stored between executions as the [State](./realm-state.md)