Skip to content

Commit

Permalink
Add maintenance and withdrawal
Browse files Browse the repository at this point in the history
  • Loading branch information
grahamgilbert committed Dec 5, 2024
1 parent 7d03bf4 commit bfd9bd7
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 3 deletions.
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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 <a rel="me" href="https://hachyderm.io/@macadminsopensource">@macadminsopensource@hachyderm.io</a> on Mastodon.


<iframe src="https://github.com/sponsors/macadmins/button" title="Sponsor macadmins" height="32" width="114" style="border: 0; border-radius: 6px;"></iframe>
17 changes: 16 additions & 1 deletion project-onboarding.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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 <[email protected]> with your request.

0 comments on commit bfd9bd7

Please sign in to comment.