Documentation Repository

[cjgordon]

It would be a good idea to have a public repo that all users could contribute to with documentation specific to openBalena.

Currently there is good documentation for balenaCloud which covers a lot of the operational use of balena but not the specifics of setting up and maintaining openBalena.

There are a number of excellent posts in the forums that have saved me hours of effort to work out different aspect of the system I would immediately transpose to documentation and credit.

Some posts in the forums I can think of off the top of my head:

• https://forums.balena.io/t/howto-ssh-into-host-device/5312
• Notes on Host Updates
• https://forums.balena.io/t/vpn-certs-seems-to-be-expired/262191/10

[jellyfish-bot]

[markcorbinuk] This issue has attached support thread https://jel.ly.fish/7a915c56-ac9c-4d5b-9c5e-fbbf5a23a115

[andrea60]

I think this is a very good idea and I'd like to contribute too. OpenBalena requires some tweaks and some additional knowledge to properly run the system (ssh tunneling, networking, certificates management). All this information is there but it's buried inside the forum.
For example, certificates expiration management is a crucial activity that is not mentioned at all in any official doc.

[bartversluijs]

Count me in!

[andrewnhem]

@bartversluijs @andrea60 @cjgordon We hear yall loud and clear. I'm working on a way to at least get some kind of a minimum-viable thing to test. Hang tight!

[andrewnhem]

@bartversluijs @andrea60 @cjgordon : Hello! It's been a while, but I hope you all are well. Some updates!

• we're working on that new openbalena site I mentioned above, so hang tight for some guidance on where to contribute docs/user guides
• Slightly similar, but I really want to make a collection of best practices and must-know things for edge developers and IoT fleet owners: https://forums.balena.io/t/id-like-to-create-an-edge-developers-guide-to-the-galaxy/353193

Yall have the expertise and energy to teach and inspire others and I want to celebrate and harness that. Please check that out and let me know what you think.