2023-12-06 Meeting notes for Documentation Working Group

Owned by Joseph Pearson
Last updated: Dec 06, 2023
2 min read

Date

Dec 6, 2023

Attendees

 

  • @Joseph Pearson

 

Fortnightly Review (actually a month this time)

Discussion items

  • Thank you, @Rene Cherny (Deactivated) for your years of service!  
    Have you been with Open Horizon almost five years?
    This WG created July 16, 2020 and you joined the mailing list August 4, 2020.

    • Active in both wiki and discussions, instigated our best practices

    • Created commits, PRs, reviewed many

    • Was our primary (and only) editor, helping us with grammar, spelling, tone, voice, consistency, and clarity

    • Provided a necessary non-engineer perspective, and yet had no issues communicating between the disciplines

    • Facilitated Open Horizon documentation synchronization with downstream vendor docs, not an easy task

  • The orphan page checker may need some maintenance to address warnings, maybe.

  • What do we need to do to address OpenBao documentation?

    • Uses mdx  file format

    • Served dynamically with NodeJS

    • Tempting to convert to md and GitHub pages, but that will take significant work

New content

2023 Year in Review for Open Horizon

In 2023, Open Horizon continued to grow the community and mature as an organization.  This year, one of the challenges we encountered was swapping out critical software dependencies when projects we relied on migrated their software licenses from open-source Apache or MPL to the source-available BSL 1.1.  In both instances, the open-source community stepped up and forked the open-source codebase to create a new project.  And in one of those instances, Open Horizon has led the effort by incubating that forked project internally.

Here are some key accomplishments:

  • Added support for RHEL 8.8, 9.1, 9.2, 9.3, Fedora 38, and Debian Bookworm

  • Ported our agent to arm64 for Mac M1/M2 and s390x (mainframes on the edge)

  • Community-led feature requests: realtime metrics, runtime security

  • New Adopters: Mainsail, LiquidPrep

  • RCOS Spring 2023 mentorships

  • Open Horizon used in IBM Edge Application Manager 4.5.x, Falcon Tactical Edge

  • Earned OpenSSF Best Practices badge

Action items