From bfd9bd73b82dbf5b26a962f5c354f0f083f8f937 Mon Sep 17 00:00:00 2001 From: Graham Gilbert Date: Thu, 5 Dec 2024 07:34:02 -0800 Subject: [PATCH] Add maintenance and withdrawal --- README.md | 6 ++++-- project-onboarding.md | 17 ++++++++++++++++- 2 files changed, 20 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 652d04c..b037016 100644 --- a/README.md +++ b/README.md @@ -6,13 +6,17 @@ title: Mac Admins Open Source [Mac Admins Open Source](https://github.com/macadmins) exists to provide the code signing certificates which are now required due to increased security requirements in macOS, to open source projects which are used in SMB, enterprise and education environments across the globe. ## Join the Mac Admins Open Source Board + We are looking for involved members of the Mac Admins Open Source Community who are interested in helping to steer the direction of Mac Admins Open Source. [Learn more](/join-the-board/) ## Macadmin Tools + You can find a community maintained list of tools at our sub-wiki page: [Macadmin Tools](https://github.com/macadmins/macadmins.io/wiki/Macadmin-Tools) ## Notable Projects + Notable projects within the Mac Admins Open Source include: + * [Nudge](https://github.com/macadmins/nudge) - A tool for encouraging the installation of macOS security updates. * [InstallApplications](https://github.com/macadmins/installapplications) - A tool for dynamically using installapplication * [MacAdmins Python](https://github.com/macadmins/python) - Framework files for use with popular python macadmin toolsets @@ -23,8 +27,6 @@ Notable projects within the Mac Admins Open Source include: * [SupportCompanion](https://github.com/macadmins/SupportCompanion) - macOS helper application designed to empower end-users * [Munki Builds](https://github.com/macadmins/munki-builds/releases) - Code signed [Munki](https://github.com/munki/munki) builds - You can find us in the #macadmins-opensource channel on the [Mac Admins slack](https://www.macadmins.org/) or @macadminsopensource@hachyderm.io on Mastodon. - diff --git a/project-onboarding.md b/project-onboarding.md index 406fdda..16a8e7d 100644 --- a/project-onboarding.md +++ b/project-onboarding.md @@ -12,7 +12,7 @@ The Mac Admins Open Source organization exists to serve open source projects wit There are a few expectations that must be met to be considered for signing/hosting. They are as follows: -* Only the project owner can request to join the Mac Admins Open Source organization on Github. +* Only the project owner can request to join the Mac Admins Open Source organization on Github * The project must be actively maintained * Must be Mac Admin related (day to day, machine management, etc) * The project must benefit from being signed, such as an .app or binary that needs to be scoped for a PPPC configuration profile. @@ -29,3 +29,18 @@ Once the request has been made, the following steps will be taken: * If approved, a private channel will be created on the [Mac Admins Slack](https://macadmins.org) to facilitate communication and complete work around this process * The maintainer of the project will migrate the repo into the Mac Admins github org and the maintainer will be granted permissions to the repository * Once the project is migrated, signed and all other work is complete, the project will be made public and will be announced in [#macadmins-opensource](https://macadmins.slack.com/archives/C0224B1QUSK) as well as various social media outlets. + +## Maintenence + +* It is expected that projects will be maintained over time and have a primary maintainer +* If circumstances change and the primary maintainer can no longer manage the project, they are expected to find a new maintainer to carry on the work +* If a project is unmaintained for a year, it will be archived +* Maintenance tasks should include + * Resolving security issues + * Ensuring the tool is able to run on the latest version of applicable operating systems + * Ensure documentation is current and accurate + * Review incoming pull requests + +## Withdrawing from Mac Admins Open Source + +If for any reason you would like to move your project out of the Mac Admins Github org, please contact with your request.