diff --git a/articles/software-self-service.md b/articles/software-self-service.md index 084b9de7db..4db5056529 100644 --- a/articles/software-self-service.md +++ b/articles/software-self-service.md @@ -52,7 +52,7 @@ On your Mac, open [iMazing Profile Editor](https://imazing.com/profile-editor). You can also download the configuration profile (`.mobileconfig`) and change values in code editor. If you want to change the icon, use iMazing Profile Editor and follow the steps above. -Download example Web Clip profile from [our repository](https://github.com/fleetdm/fleet/tree/main/docs/solutions/ios-ipados/Fleet-self-service.mobileconfig). +Download example Web Clip profile from [our repository](https://github.com/fleetdm/fleet/tree/main/docs/solutions/ios-ipados/configuration-profiles/fleet-self-service.mobileconfig). ## IT admin experience How to view, update, install, or uninstall self-service software: diff --git a/docs/solutions/README.md b/docs/solutions/README.md index 1a2f9acf9d..7ec6b682af 100644 --- a/docs/solutions/README.md +++ b/docs/solutions/README.md @@ -1,10 +1,23 @@ -# Solutions Best Practices +# Solutions +## Best Practices -## General +### General - Name the file what the profile does. - For example, instead of `googlePlayProtectVerifyApps.json` (the name of the Android policy for this control), describe what it does: `enforce-google-play-protect.json`. - Use kebab case in file names, with all letters in lowercase. - Instead of `passwordPolicy.json`, use `password-policy.json`. - Be sure to end files with an empty newline. + + +### symlinks + +If a solution is applicable to multiple platforms, keep the original in the main platform directory and symlink it to the other platforms. For example, if an Apple configuration profile can be used on both macOS and iOS, use macOS as the source, and create a symlink in the iOS directory. + +- `cd docs/solutions/ios-ipados/configuration-profiles/` + - Note that this is the destination that we want the symlink to be in. +- `ln -s ../../macos/configuration-profiles/my-profile.mobileconfig .` + - The `.` here at the end means the current directory, and will use the same file name as the original (which is what we want). +- `git add profile.mobileconfig` +- `git commit` diff --git a/docs/solutions/ios-ipados/Fleet-self-service.mobileconfig b/docs/solutions/ios-ipados/configuration-profiles/fleet-self-service.mobileconfig similarity index 100% rename from docs/solutions/ios-ipados/Fleet-self-service.mobileconfig rename to docs/solutions/ios-ipados/configuration-profiles/fleet-self-service.mobileconfig diff --git a/docs/solutions/ios-ipados/configuration-profiles/wifi-network.mobileconfig b/docs/solutions/ios-ipados/configuration-profiles/wifi-network.mobileconfig new file mode 120000 index 0000000000..d3cc76595d --- /dev/null +++ b/docs/solutions/ios-ipados/configuration-profiles/wifi-network.mobileconfig @@ -0,0 +1 @@ +../../macos/configuration-profiles/wifi-network.mobileconfig \ No newline at end of file