Dear all-

I would like to encourage you to start reaching out in whatever medium you feel comfortable with in the next month before the hackathon. Although BONSAI has been around for a while, we have more interested people bringing more ideas and more energy than ever right now. The hackathon is our best chance to finally turn these principles into an actual product, which in turn could lead to a huge increase in engagement and data provision. So even if it feels a bit awkward or arrogant, you have the right to celebrate being part of a movement in the right direction. Share your passion, and you will inspire passion in others! Or, as one of the leading lights in modern philosophy said: "Just do it!"

Personally, I am making an open commitment to writing a blog post a week for the next five weeks (I am mostly announcing this in public so that I have to actually do it :). The first post is "What would a modern Industrial Ecology database look like?" The topic next week will be the management structure of BONSAI, both currently and possibilities for the future.

Yours,
Chris

Hi Chris,

Happy to share infos and blog posts on my twitter (https://twitter.com/kst_stadler) and can probably cross-post on the NTNU  IndEcol twitter account (if of general interest).
Specifically for the hackathon - are you still looking for participants; or should I rather post something general regarding Bonsai?
best
kst

I think we are more or less complete, unless someone comes with special expertise relevant to the specific deliverables.

I was thinking more about reaching out on the general purpose and philosophy behind BONSAI, and how this is a chance to build the future that most of us want.

ok,
https://twitter.com/kst_stadler/status/1100379225373245440

just started the hashtag #BONSAI , hitch-hiking small trees...

Following from Chris's post here, this is my audit of existing Bonsai communication mediums. Plus suggestions for changes that I'd like to open for comment before taking action which affects everyone.

The goal of this effort is to organise the Bonsai mediums such that interested people can quickly navigate to the most up-to-date information which is relevant for them. This way they are more likely to properly understand the project without unnecessary struggle. Once they have this understanding, their path toward meaningful contributions should also be clear. This is particularly important with the recent flurry of activity and upcoming outreach.

Current state

Github

Bonsamurais organisation (17 members) containing:

·       4 repositories

o   The Bonsai repository contains the Wiki, where tasks are currently managed (e.g.)

·       A top-level project board made my Chris today but not yet used

Groups.io

Best navigated on the web-interface (although I've found rich-formatting of posts is not so friendly)
You can update your email settings to prevent spam here and via hashtags.

·       main (24 members)

o   hackathon2019 subgroup (16 members – note that posts here won’t necessarily reach the 8 people exclusively in Main)

LinkedIn:

·       A 'company' (59 followers)

·       A closed 'group' (339 members!)

o   "About this group" is the only publicly visible part. It does not include links to other open Bonsai mediums

Website

https://bonsai.uno/ contains

·       static pages

·       some document hosting here.

·       Fairly detailed descriptions of planning and strategy

o   it's not clear whether this or the wiki pages are authoritative on this topic, and there’s much duplication

·       web-app hosting on this domain suggested

Google docs

Root and subfolders shared with various email addresses; anyone with the link can edit. Subfolders:

·       ‘documents’ - 8 sets of minutes from Developer and Board meetings

·       ‘classifications and correspondences’ - 24 Google spreadsheets

Slack

https://bonsai-open.slack.com for chat

·       Invitation Link

·       Chris has stated he intends to also upload the chatlogs from the public channels for transparency

·       Private channels can be used for private comms

 

Other currently planned mediums

Sphinx

For documentation of functional Bonsai software (source)

Zoom.us

For video calling/conferencing.

·       Bo has a paid plan and has requested he be contacted for scheduling

·       Zoom can be integrated into Slack for video meetings (but hasn’t yet)

Not found

Previous funding applications. These could be useful for potential future applications.

 

Change proposals

·       The wiki becomes the primary destination for up-to-date information, with only stable information on the website (plus eventually the web-apps)

·       Use the Github 'Projects' functionality for task management.

o   When tasks relate to specific repos, use the 'projects' in those.

o   For higher-level tasks or ones that presently lack repositories, use the top-level Bonsai organisation 'projects'

 

Action points

1.       Update the wiki front-page (or make a dedicated page) with the outcome of this discussion.

a.       use this as the general "contributing guidelines" (or similar) for the organisation. Stating how we agree to use the various comms mediums and tools such as GitHub Issues etc.

b.       This becomes the basis for the #GettingStarted guide referenced by Chris

2.       Update LinkedIn (group and company) descriptions with a prominent link to the Wiki front page

3.       The Google Drive and website meeting documents are hosted for posterity as pdfs at a single location (I suggest the website only, as they are static)

4.       Delete the copies from other locations

5.       Add previous funding applications to the same location.

6.       Add any missing information from the website-hosted strategy and work plan to the wiki. Then delete these webpages

7.       Add a link to the Groups.io mailing list in the website contact section

8.       Edit the ‘Status and statutes’ section:

a.       ‘Status’ implies up-to-date: hence reference the wiki

b.       ‘Statutes’ are static: with other website-hosted documents

9.       Move the 5 pages of tasks to appropriate GitHub organisation or repository Project Boards

Further questions

1.       The LinkedIn group is not open. Is this by default or is there a rationale for requiring an invitation before people can join?

2.       Paid 'Membership' is currently only emphasised on the website. Should this option be made more prominent elsewhere?

I look forward to any corrections / additions / proposal comments!

I think this is a great start - I hope that you and a few others can put together a detailed plan including a repo with separate pages for what the website could look like, as well as a guide for newcomers, so that we can get to group consensus.

One small clarification - Sphinx is a tool to convert documentation from one format to another, for example to convert the Brightway docs from restructured text to HTML. It isn't a communication tool per se.

Weekly post #2: Governance structure of BONSAI, with specific suggestions for changes. Comments and critiques are welcome.

We will have the general assembly for 2019 a bit after the hackathon, so we have some time to process the work that was done there. Please indicate your availability on the following doodle: https://doodle.com/poll/ehvevkibuvbiihu6.

We should maybe mention that to participate in the General Assembly, which is the formal governing body of BONSAI according to the Statutes, a formal membership is required, which you obtain by paying a minimum contribution of 150 EUR at https://bonsai.uno/contribute/

Bo

It seems that not all the hackathon participants have filled up the doodle pool yet. We should have a date soon so please fill the doodle :)

I welcome Chris' suggestions about the management of the BONSAI organization. 
Perhaps, we also should define the criteria for waiving the membership fee to contributors (i.e. define "participants in BONSAI activities"). I wonder whether this would require changes to the statute.

Hi Michele,

sorry for not filling up the doodle.
I was not actually planning to participate in the GA...
I'm not 100% sure about what is its scope actually.

Thanks,
Matteo

On Wed, 6 Mar 2019 at 13:41, Matteo Lissandrini (AAU) <matteo@...> wrote:

sorry for not filling up the doodle.
I was not actually planning to participate in the GA...
I'm not 100% sure about what is its scope actually.

The general assembly is the annual meeting of the BONSAI non-profit
organization. There is no fixed agenda, nor any proposed agenda yet;
you can read the minutes from previous meetings and the BONSAI
statutes here: https://bonsai.uno/organisation/. We will have more
specifics after the next board meeting. Currently, participation is
limited to BONSAI members; details on membership here:
https://bonsai.uno/contribute/.

BTW, this will be in May, not March :)

Thanks,
Matteo

--
############################
Chris Mutel
Technology Assessment Group, LEA
Paul Scherrer Institut
OHSA D22
5232 Villigen PSI
Switzerland
http://chris.mutel.org
Telefon: +41 56 310 5787
############################

Thank you very much for this summary and for proposing those action points Tom.

After a chat with Tom, my inputs and proposals are listed below:

About Tom's change proposals:

I fully agree with the following suggestion: the website is a static document with basic general information; the wiki "becomes" the primary destination for up-to-date info. In fact, this is already what is happening. The wiki, perhaps in the "getting started" section, should make this distinction clear, linking to the web-page when mentioned; and yes, the participation fee should also be mentioned.
NOTE: The fee and the cases in which the fee might be waved for contributors will be discussed at the next board meeting (next week).

About the action points:

1. Agree on making a dedicate wiki "Getting-started" page which includes links to basic resources and information. The info in the current wiki front page could be linked to this page and mentioned as a "what is the purpose of this wiki?" or something like that.
2. LinkedIn groups: the page of the "Bonsai NGO" is just used by the management for advertising relevant events or outcome of the community. If you have something relevant to our activities that you want to post on our LinkedIn page you are of course more than welcome to contact me. The LinkedIn group was instead born before LinkedIn changed the policy on closed groups, which are now not visible unless one is invited to them. The board will discuss at the next meeting whether we should now close this group completely and inform the member that daily updates are now taking place on this mailing list or if we should just inform that but keep the group. In any case, yes the group.io took over the Linked In group as a main communication mean. 
3. The content on the google drive will be moved (by me). The static documents (e.g. all the minutes of meetings) will be hosted on an "archive" like section on the website (i.e. static info); the mapping and correspondence file will be converted in a machine readable version and move to the GitHub (by me) asap, as part of the working group on correspondence table ("Group 10" in Chris' pool). If you create a section for each group under Projects on the wiki that could be a good place for hosting them, for example. 
4. Agree, copies will be deleted from other locations (by me).
5. Experience gained through previous funding applications by network members can definitely be shared within the network for future applications. Clearly, getting funds to finance also a piece of this big puzzle is a common interest. However, I'd avoid publishing them online since they were mostly not in the name of Bonsai, which doesn't have yet sufficient credentials. I am confident this will change soon. 
6. Outdated information will be removed from the website and moved to an archive as described in point 3 above. Yet, the content of the strategy and work plan  can still be useful on the web page, that we don't want to empty out of all content. Indeed, the web-page is still an useful "high level" marketing tool, a sort of brochure with more static info. If you have suggestions on updating specific content on the web-page (other than what I have already mentioned) please let me know, they are more than welcome.
7.  I propose to add a link to the group.io on the wiki in the "getting started" section that you Tom proposed, rather than on bonsai.uno (that already has a link to the wiki, in case someone ends up on the web-page first). On the wiki instead, I propose to (also) gather all link in a "Useful link" section with links to external resources (external to our Bonsamurai GitHub).

About your fuehrer questions: 

1. I agree that ‘Status and statutes’ will become only statute and include a link to it. For the status we will forward to the wiki. I will take care of the modifications.
2. As already mentioned, the "getting started" new section that you proposed will also kindly remind the visitors of the page that we have a modest membership fee.

Thank you for this initiative Tom! Further feedback and contributions are very welcome! 

Michele De Rosa

Dear all-

I have developed a formal structure for making community decisions, based on the Python enhancement proposal template (PEP) that many other software projects use. You can find the draft here: https://github.com/BONSAMURAIS/enhancements/blob/master/beps/0002-bonsai-project-community-governance-structure.md, and the repository here: https://github.com/BONSAMURAIS/enhancements/.

As eating your own dog food is generally good practice, I propose that we test this system on itself. To do this, someone who is not in my circle of friends would need to volunteer as an editor for BEP 2 (BEP is BONSAI enhancement proposal, and it describes what an editor does).

I look forward to your ideas, suggestions, and critiques! If accepted, we would then use the BEP process for the hackathon as well - it is sometimes a bit of a pain, but I promise it will pay off in the end.

Sorry, there was a comma at the end of the first link (thanks Romain), here is the correct link: https://github.com/BONSAMURAIS/enhancements/blob/master/beps/0002-bonsai-project-community-governance-structure.md.

Weekly post #3: Modular BONSAI components. Comments and critiques are welcome.

This sounds good to me, please submit a PR with the suggested types, and add your name to the authors list!

Still looking for an editor :)

Sorry, this was supposed to be in response to Romain's email about adding another metadata field.

Dear all-

I had a very nice talk today with Oleg Lavrovsky, who makes his living as an independent open data consultant (https://datalets.ch/). He organizes most of the open data hackathons in Switzerland, and is active in sustainability data as well, so I think his feedback is worth listening to. Here are the points I noted:

We desperately need a getting-started guide - this should be the first thing one sees, after the small motivation section. We want to communicate from the beginning that each visitor has something to contribute, and that we need their contribution.

As a part of this getting-started guide, it would be worth building a sort of toolbox for beginners to bonsai, like the one found here: http://toolbox.schoolofdata.ch/. The idea is that we will have a bunch of people looking at our site who aren't experts in coding or semantic tech, but who are motivated to participate. If they see a wall of complications, they will just close the tab and move on, but if they have a list of tools with good docs and tutorials that will give them a chance to start contributing in a meaningful way.

In his experience, hackathons work best if there is one focus. In our case, I think it is worth re-emphasizing that the goal of the hackathon is to have a complete working demo that we can show people, and it probably makes sense to focus on getting the existing work packages to be good instead of starting a bunch of the stretch goals (though I have been dreaming of a bunch of BONSAI components: https://chris.mutel.org/bonsai-components.html).

He felt that the hackathon was a good opportunity to already involve more people online, and that there would be an audience if we did more outreach. Online participants need to be able to work independently, which means that we should have some example small projects that people can just claim and work on.

As a follow-up to this, I think it would very good to have a list of projects where we need help - this would allow people to either pick a project, or to get a sense for the kind of projects BONSAI works on, so that they can define their own. Here are some examples I can think of:

• Simple API that would take barcodes and a region, and spit out an LCA score and contribution analysis.
• Guess labels from BONSAI product and industry names based on a machine learning classifier. Keeps original data, just adds new columns. Takes CSV or RDF as input. Training data will come from the descriptions and documentation of the ontologies.
• Extract the car model from https://pubs.acs.org/doi/abs/10.1021/acs.est.8b00261 (maybe combining with GREET: https://greet.es.anl.gov/) and make it web-accessible and following BONSAI coding standards.
• A set of global and regional independent validation data for LCA/MFA, e.g. how much CO2 was produced in 2018, how much land was transformed, how much shipping happened, etc.

A key to hackathon success is to make sure that everyone can make meaningful contributions. Each person should be a champion or leader of their task/deliverable. Key here is fostering a positive and welcoming atmosphere, and being flexible as groups evolve.

One idea that was new to me was to have a data-driven hackathon, where we would be measuring data about the hackathon itself. Oleg and his team have developed https://datalets.ch/dribdat/, and though it is difficult to explain, it is quite cool to see in action. He would be willing to set up an instance for our hackathon.

Finally, we only get one chance to make a first impression, so all our communications should reflect and emphasize our core values, especially our embrace of openness, both in consuming open data, and in making our data available for others. We want people like Oleg to see our website and feel at home, knowing that this is a place where he could make a difference. It isn't easy, which is why we need to start ASAP.

I see that Oleg has joined our list, so he is welcome to add/edit the above points :)