From 1211b265ac8f5c9342c6627af1269c7fb14325e5 Mon Sep 17 00:00:00 2001
From: Marine DECHAMP-GUILLAUME <92780073+MdechampG@users.noreply.github.com>
Date: Wed, 7 Feb 2024 15:26:00 +0100
Subject: [PATCH] fix(academy): fix some types and improve wording
---
docs/academy/overview.mdx | 20 ++++++++++++--------
docs/academy/rules.mdx | 2 ++
2 files changed, 14 insertions(+), 8 deletions(-)
diff --git a/docs/academy/overview.mdx b/docs/academy/overview.mdx
index a164c457215..e43f258d24f 100644
--- a/docs/academy/overview.mdx
+++ b/docs/academy/overview.mdx
@@ -3,7 +3,7 @@ sidebar_position: 1
sidebar_class_name: hidden
---
-# Academy overview
+# Academy overview
Welcome to the OKP4 Academy, your gateway to the cutting-edge world of off-chain resource sharing and orchestration. In an era where the efficient utilization of resources is paramount, the OKP4 protocol emerges as a groundbreaking solution. OKP4 specializes in the seamless sharing and orchestration of off-chain resources.
@@ -25,24 +25,26 @@ OKP4 is a public blockchain built to share and orchestrate any off-chain resourc
:::tip
Before delving into the academy modules, we strongly recommend familiarizing yourself with essential sections of the OKP4 Whitepaper:
+
1. The [Abstract](/whitepaper/abstract): Gain a broad overview of the OKP4 protocol to understand its fundamental principles.
2. The [Introduction](/whitepaper/introduction): Explore the challenges within the knowledge economy that OKP4 addresses.
-3. The [Solution](/whitepaper/solution): Discover the high-level concepts and key features underlying the OKP4 protocol.
+3. The [Solution](/whitepaper/solution): Discover the high-level concepts and key features underlying the OKP4 protocol.
+
:::
The Academy is structured into two main parts to cater to diverse learning needs:
-**[Part 1 - Fundamental Concepts:](#concepts-of-okp4)**
-This section offers an accessible exploration of the foundational concepts of the OKP4 protocol. Whether you're new to the protocol or seeking a comprehensive understanding, this part provides the necessary groundwork.
+**[Part 1 - OKP4 Basics:](#learn-the-basics-of-okp4)**
+This section offers an accessible exploration of the basis of the OKP4 protocol. Whether you're new to the protocol or seeking a comprehensive understanding, this part provides the necessary groundwork.
**[Part 2 - Technical Implementation:](#learn-how-to-play-with-okp4)**
Dedicated to builders and developers, the second part of the Academy delves into the technical intricacies of interacting with the OKP4 protocol. From implementation details to advanced functionalities, this section equips you with the skills needed to harness the full potential of OKP4.
Embark on your journey through the OKP4 Academy, where knowledge meets innovation. Whether you're a novice or an experienced developer, we invite you to explore and master the protocol that is shaping the future of the knowledge economy.
-## Learn the concepts of OKP4
+## Learn the basics of OKP4
-Now you have a basic understanding of OKP4, let's delve into the core concepts behind the OKP4 Protocol.
+Now you have an overview of OKP4, let's delve into the core concepts behind the OKP4 Protocol.
@@ -171,7 +173,7 @@ Now you have a basic understanding of OKP4, let's delve into the core concepts b
>
Describe a Zone
-
Declare a dataset or a service in the Dataverse.
+
Describe a Zone in the Dataverse.
@@ -182,8 +184,10 @@ Now you have a basic understanding of OKP4, let's delve into the core concepts b
>
Zone's governance
-
reate the resource governance
+
Create the resource governance
+
+You have a question or a feedback? You need help from the team? Please contact us on the [Academy support channel](https://discord.com/channels/946759919678406696/1204793117996486676) on Discord.
diff --git a/docs/academy/rules.mdx b/docs/academy/rules.mdx
index 952ab04e235..9a5a44b5229 100644
--- a/docs/academy/rules.mdx
+++ b/docs/academy/rules.mdx
@@ -14,6 +14,8 @@ import * as quiz from './rules-quiz.json';
The key feature of the OKP4 protocol is the ability to define rules within its ecosystem. The term **"Rules"** forms the backbone of the protocol, governing how off-chain digital resources like datasets, algorithms, storage, and computation resources are shared and managed. These rules define the parameters and conditions under which resource sharing and interactions occur. Understanding the scope of what can be defined within these rules is crucial for harnessing the full power of the OKP4 protocol.
+A [zone](https://docs.okp4.network/whitepaper/solution#zone-overview) is a conceptual framework defined by a set of rules, within which the recognized digital resources are compatible with these rules, taking into account the associated consents. A resource is not attached to a zone. The recognition of resources within a Zone relies on the dynamic evaluation of the conformity of the rules and consents of the resources.
+
The OKP4 protocol enforces rules for governance and consent. When users want to do something in a Zone (launch a workflow to create new indicators or train an AI model, for instance), the protocol checks if it's allowed based on the rules. This decision considers the current situation, as blockchain rules and digital resources constantly change. From a computer science perspective, the challenge is dealing with complex logic involving rules, such as hierarchy, inconsistency, and dependency.
To handle this, the OKP4 protocol ensures a secure and reliable way to interpret rules in a decentralized manner. The rules in each Zone and the consent attached to a resource determine if a user's action is permitted. It's essential to remember that this assessment also considers the evolving state of the blockchain at the time of the request.