Date   

Re: Outreach in the buildup to the hackathon

 

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


Re: A formal structure for community governance

 

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.


BEP0001

romain
 

Hi,
 
in the proposed BEP template (BEP0001), could there be a "type" hashtag in the header? Like in https://www.python.org/dev/peps/pep-0001/#pep-types
 
Since we'll likely be dealing with a wide range of issues, it could make sense to categorize these enhancement proposals in broad categories (e.g., proposed software features, proposed guidelines, etc.). Just an idea.
 
/Romain


A formal structure for community governance

 

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.


Re: Online #KnowledgeManagement - audit and suggestions for change #knowledgemanagement

Michele De Rosa
 

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


Re: Outreach in the buildup to the hackathon

 

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
############################


Re: Outreach in the buildup to the hackathon

Matteo Lissandrini (AAU)
 

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


Re: Outreach in the buildup to the hackathon

Michele De Rosa
 
Edited

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.


Re: 2019 General Assembly

Bo Weidema
 

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

Den 2019-03-02 kl. 08.50 skrev Chris Mutel:

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.


2019 General Assembly - Doodle poll

 

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.


Re: Outreach in the buildup to the hackathon

 

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


Re: Online #KnowledgeManagement - audit and suggestions for change #knowledgemanagement

 

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.


Online #KnowledgeManagement - audit and suggestions for change #knowledgemanagement

Tom
 

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!


Re: Outreach in the buildup to the hackathon

Konstantin Stadler
 

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

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

On 26/02/2019 13:42, Chris Mutel wrote:
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.


Re: Outreach in the buildup to the hackathon

 

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.


Re: Outreach in the buildup to the hackathon

Konstantin Stadler
 

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


Outreach in the buildup to the hackathon

 

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