Welcome to the management and documentation repository for the Bonsai organisation (named Bonsamurais on GitHub).
This repository hosts the Wiki which describes all components of the BONSAI modular software architecture (work-in-progress!). This prominent README document describes how to get started with Bonsai.
If you're a potential Bonsai developer/contributor: you're in the right place. There are many ways to contribute. This page will try to effectively direct your energies. Not sure if you want to contribute? See here!.
For potential Bonsai user, open data on BONSAI can be accessed from the Open Virtuoso triplestore. Accessing data from the triplestore requires SPARQL know-how. Development of easy to use tools is currently ongoing. Meanwhile some example queries have been developed to help users extract data.
Overviews and priorities
If you wish to contribute, a starting point could be to look at the BONSAI repositories overview page. The figure below explains how (some of) the project repositories described in the BONSAI repositories overview are linked (editable version here). The project dependencies image instead, intends to support the prioritisation of tasks.
What is the current development status?
The Bonsai project is currently undergoing development, since the March 2019 hackathon. The topics discussed during the hackathon are available on the dedicated bonsai.groups.io page. BONSAI is currently in pre-alpha, with no official software released. The development status is also visible in the project board.
How to communicate with other developers?
The BONSAI enhancement proposal BEP0004 describes the knowledge management and internal communication strategy of the organisation.
What do we mean when we say 'Bonsai'?
The term Bonsai (big open network of sustainability assessment information) is used within the community for various related concepts. The BONSAI association is a non-profit headquartered in Denmark. The big open network extends well-beyond this organisation, to include the volunteers, digital artefacts, concepts and processes which constitute the full Bonsai project. Core software modules may also be referred to collectively as Bonsai, although the boundaries of correct usage here are not yet final or formalised.
Where is BONSAI described?
High-level descriptions of goals and objective of BONSAI is available at the Bonsai website. This Wiki provides an up-to-date consensus description of the Bonsai project. An overview of the different BONSAI repositories and their content can be found here
work plan hosted on the website.The tasks and planning on the Wiki supercede the static
Code-of-conduct and decision-making process
Participation is subject to the BONSAI code of conduct.
A proposal for using Python-style Bonsai enhancement proposals (BEPs) has been formulated and is under discussion.. The organisation Chair Chris Mutel has blogged about his thoughts on this topic here
Expected/useful knowledge for contributors
There are many ways to conribute, which require different knowledge and skills, mostly relating to software development. Some general knowledge areas that are useful for all contribution forms are suggested here.
As a distributed collaborative open-source project, we have chosen GitHub for our version control management and project management (decision pending). To contribute source code, you will need to understand the standard GitHub workflow. To help with task management and organisation, familiarity with the usage of Issues will help.
The sai in Bonsai stands for sustainability assessment information. Most contributors have a background connected to Lifecycle Assessment (LCA) and/or environmentally extended input-output analysis (EIOA). High-level decision making requires knowledge of this context. However vital low-level contributions do not require this background knowledge.
Resource Description Framework
The W3C standard RDF is used for modelling knowledge and brings numerous benefits (such as allowing to link different data sources consistently). This is related to Linked Data, and the Semantic Web. Understanding RDF will help you to understand what makes Bonsai unique and potentially very powerful. The final two sets of presentation slides of this Web Fundamentals course are a good starting point and contain links to many other resources.
We assume that you recognise the importance of sustainability assessments: to create a world which is more sustainable - society must have a scientifically-grounded understanding of environmental and social impacts of products and processes. But why should you put your efforts into the Bonsai project specifically? Sustainability assessment, and life cycle assessment (LCA) in particular, is to a large extent built on cathedrals - large background databases, erected by the efforts of many people over a long period of time, but which are now both expensive and exclusive, and whose gatekeepers limit access to both the data and decisions on its management. BONSAI believes in another model, a bazaar where the entire community can contribute to data generation, validation, and management decisions. We strongly feel that an open database is more transparent and more reproducible, and therefore the only option for the science of life cycle assessment. Such databases are also a prerequisite for LCA studies being used to support democratic decision making.