Skip to content

Commit

Permalink
docs: add index in intro.md file, add first introduction part (Aggreg…
Browse files Browse the repository at this point in the history
…ate Programming paragraph) and minor changes
  • Loading branch information
Danix002 authored and DanySK committed Nov 7, 2024
1 parent a262750 commit 3686df2
Show file tree
Hide file tree
Showing 7 changed files with 53 additions and 4 deletions.
1 change: 1 addition & 0 deletions site/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,3 +18,4 @@
npm-debug.log*
yarn-debug.log*
yarn-error.log*
yarn.lock
11 changes: 9 additions & 2 deletions site/docs/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@
sidebar_position: 0
---

# Collektive Introduction
# Collektive Documentation

todo
## Index
1. [Getting Started](/docs/gettingstarted/)

2. [Introduction](/docs/category/introduction/)
- [Aggregate Programming](../introduction/aggregate-programming/)
- [Field Calculus](../introduction/field-calculus/)
- [What is Collektive](../introduction/what-is-collektive/)

1 change: 0 additions & 1 deletion site/docs/introduction/Aggregate Programming.md

This file was deleted.

2 changes: 1 addition & 1 deletion site/docs/introduction/_category_.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,6 @@
"position": 20,
"link": {
"type": "generated-index",
"description": "Descrizione della libreria come si collega ai paragrafi sotto l'indice..."
"description": "(How the library relates to the Aggregate Programming and Field Calculus sections? Answer in two sentences.)"
}
}
28 changes: 28 additions & 0 deletions site/docs/introduction/aggregate-programming.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
title: Aggregate Programming
---

# The Challenge of Maintaining Distributed Systems

The **progressive increase** in the number of interconnected devices, leads to a **rise in the costs** associated with maintaining distributed systems. This creates **significant challenges** in implementing software services on a **global scale** using the traditional approach of individually programming each agent. This situation drives the search for solutions aimed at improving the **autonomy** of computing systems and **reducing their complexity**.

## Aggregate Programming as a Relevant Approach

In this context, **aggregate programming** emerges as a relevant approach. It is based on the **functional composition** of **reusable collective behavior blocks**, with the goal of efficiently achieving **complex** and **resilient behaviors** in **dynamic networks**.

### Key Properties of Aggregate Programming

- **Self-stabilization**
- **Independence from density**

These properties are initially studied on **basic building blocks**, such as:
- **Broadcasting**
- **Distance estimation**
- **Data aggregation**

These building blocks are then transferred and validated on more **complex systems** created through **functional composition**.

### Conceptual Roots in Field Calculus

Aggregate programming finds its **conceptual roots** in **Field Calculus**.

3 changes: 3 additions & 0 deletions site/docs/introduction/field-calculus.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
title: Field Calculus
---
11 changes: 11 additions & 0 deletions site/docs/introduction/what-is-collektive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: What is Collektive
---

# What is the purpose of Collektive?

# What is the purpose of Collektive?

# What problems does Collektive solve?

# What are the advantages of using Collektive?

0 comments on commit 3686df2

Please sign in to comment.