commit cee09e48ed8f107374c1b3ac85b7f85c893b88f0
parent e5841d005692b21bdf2bccfbf5961580d3f57120
Author: Paul Mackay <pauljmackay@gmail.com>
Date: Sat, 25 Feb 2017 14:07:17 +0000
Basic setup for Gitbook doc configuration
Diffstat:
5 files changed, 53 insertions(+), 0 deletions(-)
diff --git a/book.json b/book.json
@@ -0,0 +1,3 @@
+{
+ "root": "./docs"
+}
diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,12 @@
+# Value Flows
+
+
+Value Flows is a set of common vocabularies to describe flows of economic resources of all kinds within distributed economic ecosystems.
+
+Purpose: to enable internetworking among many different software projects for resource planning and accounting within fractal networks of people and groups.
+
+Or, with less buzzwords, "let's help a lot of alternative economic software projects that are solving different pieces of the same puzzle be able to work together".
+
+One of the purposes of this vocab is to support resource flows connecting many websites. These flows may be oriented around Processes, Exchanges, or combinations of both.
+
+We want to support RDF based and non-RDF based use of the vocabulary, basically any way that people want to use software and data on the internet to help create economic networks.
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
@@ -0,0 +1,6 @@
+# Summary
+
+## Introduction
+* [Introduction](README.md)
+* [Concepts](introduction/concepts.md)
+* [Principles](introduction/principles.md)
diff --git a/docs/introduction/concepts.md b/docs/introduction/concepts.md
@@ -0,0 +1,19 @@
+# Concepts
+
+
+
+Networks of value flows are created when processes are linked together through flows of resources.
+
+By process, we mean an activity that transforms inputs into outputs. The outputs might then become inputs to other processes, forming networks and chains. Those chains may be circular, where an output from one process becomes an input to another process that occurred previously in the same chain.
+
+For example: A farming process takes compost, soil, seeds, water and human and mechanical work as inputs, and transforms them into grains, nuts, fruit, and vegetables. Those ingredients may go to kitchens that create dinners for people to eat. Some of those ingredients may be pared off in preparation, or spoil, or be left on plates. Those leftovers go into compost, which starts the process chain over from the beginning.
+
+Or for a bad example: A CAFO (Confined Animal Feeding Operation) produces a lot of manure. They put manure into big lagoons, which drain into the water table, and come back up in people's drinking water, causing diseases, for which the people become inputs to a hospital.
+
+One of the inputs to the CAFO process is antibiotics. The animals are filled with antibiotics because they get sick in the CAFO environment. And the antibiotics are also an output, mixed in with the manure.
+
+The antibiotics then breed resistant bacteria, which end up in the people, and send them to the hospital, and then kill the people, because the common antibiotics no longer work. And the resistant bacteria remain in the hospital to kill other people.
+
+(This needs some more development.)
+
+We think of Economy in the original sense of [management of our household](https://en.wikipedia.org/wiki/Economy).
diff --git a/docs/introduction/principles.md b/docs/introduction/principles.md
@@ -0,0 +1,13 @@
+# Principles
+
+These principles are about the model behind the vocabulary.
+
+1. The model must enable collaboration between different people in different organizations using different software on different platforms using different human and programming languages.
+2. The model must be able to form global networks which can track the flows of resources (values) forwards and backwards. Or maybe it would be better to say "in any direction", but forwards means in the direction of value creation, and backwards means in the direction of return or compensation.
+3. Corollary: the model must be able to support value equations that distribute income (rewards) according to peoples' contributions to the creation of the values that generated the income or rewards, regardless of where and when in the network configuration those contributions occurred.
+4. The model must also be able to support coordinating work between different people in different organizations. People who are not concerned with rewards may still want to coordinate work.
+5. The model must be able to support circular economies, value flows where resources come full cycle to be fed into the same set or other processes so that recycling, re-use, and other ways to encourage resources not becoming waste.
+5. The model must be fractal. It must support global views of networks in aggregate as well as drilling down to lower and lower levels of detail. Those lower levels of detail, for example inside one organization, may require permissions.
+6. The model must also work on the Recipe, Plan and Observation levels, where the objects on each level are linked appropriately to the other levels.
+7. The model must support non-business-as-usual organizational forms and economic relationships in addition to traditional business organizations and relationships.
+8. The model must support systems where all the contributors can get shares of the outcome to allocate as they wish. In other words, a group can choose to introduce various monetary currencies into their flows but can also do all the coordination and accounting without introducing such artifacts.
