Commit 1f360a51 authored by Sandro Eiler's avatar Sandro Eiler 🐌

Updated documentation.

parent b37d1382
......@@ -3,24 +3,35 @@
Why karmantra?
==============
_karmantra_ originates from **Kar**rotish **Man**aged **T**rustbased **R**ole **A**ssignment.
It was inspired by [Karrot](https://karrot.world/).
The idea behind _karmantra_ is, to provide developers with a tool, making group roles available fast and easily.
It was inspired by the online platform [Karrot](https://karrot.world/).
TODO: ![]() Picture, showing a system with groups and users, having roles for doing things
With _karmantra_ it is possible to:
TODO: advantages of using karmantra
- making system transparent from implementing the role assignment model
- decoupling code
- ...
* build and manage role models for your system,
* evaluate user's role automatically with the help of rules,
* automate role assignment for users,
* change role models later,
* decouple roles and rules from the rest of the code,
* make assignment rules transparent and comprehensible for ALL and
* be flexible; you could even implement a system, where users can create their own role assignment model.
Who is it for
=============
Managed Trustbased Roles
========================
Today’s human societies can’t exist without trust. We trust in the system, in tools and in our fellow human beings. In socially idealistic societies, where hierarchies should be flat or even non-existent, trust is even more important. Because a groups’ success depends on its inner cohesion, it has to work out its’ very individual rules of collaboration depending on the existing needs and abilities. There is no generic system that can fit every groups needs.
_karmantra_ is for developers who want close the gap between development and organization (yes it's kind of DevOps).
If you are a developer, you can easily karmantra to deploy role models and role evaluation mechanisms.
**_karmantra_ is a framework, providing developers with a tool, allowing trust based role implementation, trigger based automatic role checks, getting statistic information and user notification.**
Who is it not for?
==================
It's not suitable for developers who intend to create systems, where only administrators/moderators/... assign roles manually.
About Karrot
============
Karrot is a platform, connecting people all over the world to save food from being thrown away. While about one billion people have to hunger, twelve billion people can be fed with today’s possibilities. Saving food from being thrown away improves consciousness for production and consumption of food. Karrots provides the possibility for groups to organize via its platform. To protect important decisions and group processes from being automated by the system, hierarchies are kept very flat. Karrot only wants to provide tools to support several actions without interfering with group decisions. This means for example, that no group structure is pretended but a tool for conflict resolution is provided.
Karrot is a platform, connecting people all over the world to save food from being thrown away.
Its motivation comes from the fact that about one billion people have to hunger while twelve billion people can be fed with today’s possibilities.
Foodsaving groups intend to raise awareness for production and consumption of food through saving food.
Karrot provides the possibility for groups to organize via its platform.
Its idea is to use automated role assignment without interfering with group’s decisions on role assignment.
Check it out and
......@@ -2,7 +2,7 @@ White Paper
===========
The master thesis behind this documentation [can be viewed here](thesis.pdf "thesis behind karmantra").
The main concepts are explained here.
The main concepts are explained below.
Contribution
------------
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment