00. Before You Begin - setup-your-mac/Setup-Your-Mac GitHub Wiki
If the core functionality of Setup Your Mac meets your needs, writing code should not be required.
SYM-Helper has virtually eliminated nearly all hand-coding
However, you must be comfortable modifying scripts before implementing this approach in production (i.e., customizing existing settings for your use-case, reading and editing JSON, etc.).
The Jamf Training Catalog, which is free to all Jamf customers, is a great place to start learning the basics.
The #setup-your-mac Channel on the MacAdmins Slack and is a great resource for best-effort support when implementing Setup Your Mac in your environment.
Please remember that the more than 1,800
#setup-your-macChannel members also have full-time jobs, all of who need to also meet their employers' deadlines.
To the best of my recollection, Setup Your Mac (1.5.0) was the first time I’d publicly posted code which I considered to be knowingly incomplete and not fully tested (for the simple reason that we don’t use the additional input fields introduced in version 1.5.0 in our environment).
When you observe code blocks which include the following comment, please be aware that “you’re on your own.”
# UNTESTED, UNSUPPORTED "YOYO" EXAMPLE
While you're invited to submit feature requests, please note that finding available cycles to custom-code a feature we won’t use in our production environment is always challenging. (Feature-complete Pull Requests are always welcome.)
Before submitting a bug report, please use the following snippet to download a fresh, time-stamped version of Setup-Your-Mac-via-Dialog.bash and ensure you can replicate the unexpected behavior:
timestamp=$( date '+%Y-%m-%d-%H%M%S' ) ; curl -o ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash https://raw.githubusercontent.com/setup-your-mac/Setup-Your-Mac/main/Setup-Your-Mac-via-Dialog.bash ; sudo bash ~/Downloads/Setup-Your-Mac-via-Dialog-$timestamp.bash
Please also review the open swiftDialog issues to help determine the source of the issue.