Publishing a v.1 of OFN handbook and super-admin guide!

Following the global gathering, I took the task to finish up a v1 of the ex “contributor guide”, now called “OFN handbook”, and the super-admin guide.

OFN handbook

The objective of this “manual” is to enable anyone interested in our project and community to learn about the project and how we are collectively organized, so they can join and play with us, or study us and get inspired for their own project. It’s the “operating manual” of the OFN community. Any contributor or potential contributor, whether it be as a dev, instance developer or sector dev content producer, can go at any moment to that guide to learn how to proceed within the community. This documents will be our “single point of truth”, and should be updated anytime we change some process, just as we update the github wiki for dev stuff.

Super-admin guide

For contributors who will specifically be instance super admin, we have built a second handbook that aims at taking the hand of new instance managers and getting step by step their setup done so they can start operating their new instance properly !

Communication plan

My proposal is:

  • to link the OFN handbook from the new global site, under the “A new way of working” page.
    I wrote a first text but @Jen please feel free to amend it / completely rewrite it if it’s not really in the style we want for the site, or …

A community of people
The Open Food Network is a distributed collaborative organization run by committed people all over the world. We are very inspired by sociocratic and holacratic governance systems, even though we develop our own governance model through the tensions that emerge.
Everyone can develop their own leadership within the community, and we try to organize somehow in a permacultural way, making sure for instance that every role can be done by at least 2 or 3 people, and that each person can fulfil at least 2 or 3 roles.
But to play and build together in a distributed team, we need common rules.
We have documented the way we work and are happy to share with you our OFN handbook !

A network of local affiliates
Those people cooperate globally but organize locally through local entities they create, and which collaborate with one another around the development and maintenance of shared open source resources to support the development of the local and sutainable food systems. The relationships between those local entities are formalized via a mutual agreement document : our community pledge.

The super-admin guide doesn’t have to be put on the website, it’s a technical document that should be shared to people who are in the process of setting up an instance / linked in Github for more general open source documentation.

Update plan

Those are just first versions, we need to improve the zapier documentation in super-admin guide, and to review a bit the priorization process in handbook. But if we think they are “good enough” (#enough) to be published already, let’s do it and then review and update whenever we change something in our process. Like Github documentation, we should all adopt the reflex to update Gitbook doc all the time ! Credentials are shared in bitwarden so it can be a shared and distributed role :slight_smile:

My questions now

  • Are you happy with those first versions ? Else thanks for your feedbacks so I can take them into account and then publish ! If you see anything important missing, please let me know !
  • Do you have comments or suggestions about the communication plan proposed ?

Of course, many people have contributed to the redaction of this document, Sally especially for the super-admin guide, and Rachel, and Lynne, and Kirsten already reviewed them, etc. Thanks you folk it’s great to work with you !

@Kirsten @lin_d_hop @Jen @Rachel @luisramos0 @sauloperez @tschumilas @lauriewayne1 @sigmundpetersen @Theodore @maikel @nick @paco and everyone else :slight_smile:


Definitely good #enough!! Amazing work!!!

I"m just finally getting a bit caught up on community posts today - and I’m blown away by this. Its SO impressive to have everything - bits and bobs of posts and such - organized into these 2 spaces. I’m so impressed with what you’ve done @MyriamBoure - bit hugs for it. I’m sitting here thinking how an extraction of the intro from the handbook, a link to the handbook, and the Olivier de Shutter video - is a perfect first newsletter for OFN Can!

1 Like

Hey @Jen ! Now that you are back, can you tell me what you think about the coms strategy on the OFn handbook ? I’d like to be able to close that task on airtable :slight_smile: If you validate it I can do the various links apart the global website as it’s not yet published, but you can validate or amend the text I proposed :slight_smile: Also We might want to share on local instances website how the OFN community works, tell in the local newsletters about the launch of the OFN handbook, etc. @lin_d_hop for UK, Jen for Aus, we don’t have yet a newsletter in France but we’ll definitely talk about it when we set it up ! Thanks for your feedback :slight_smile:

Thanks @MyriamBoure - I see someone else has added your text to the draft version of the global site, so I’ve marked the Airtable task as done :confetti_ball:

I did it actually @Jen so now I know also how to modify pages on the global website :slight_smile: But if you wanted to review the phrasing please do it ! I’ll do the other things I mentioned if no other reaction.

1 Like

Ok I did all the things I proposed in that thread so I will mark in Airtable as done the handbook and super admin guide. As an iteration we would probably need to clean the super-admin section, like review posts one by one, see if we need to add thinks in the super-admin guide, delete the posts if they are now all documented in the guide, or link to the guide, etc. But we’ll see if the need comes, closing this task for now we will reopen later if needed.