Update README for Apple Silicon, single-flavor build

Author: erikng

README.md

@@ -1,92 +1,64 @@
 # python
-A Python 3 framework that currently installs to `/Library/ManagedFrameworks/Python/Python3.framework`.
+A Python 3 framework that installs to `/Library/ManagedFrameworks/Python/Python3.framework`.
 
-Please see Apple's documentation on [file system basics](https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/FileSystemOverview/FileSystemOverview.html) for more information on the thought process here.
+Please see Apple's documentation on [file system basics](https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/FileSystemOverview/FileSystemOverview.html) for context.
 
-This is an intended replacement for when Apple removes `/usr/bin/python` (which is happening with the macOS 12.3 release Spring 2022)
+This is an intended replacement for `/usr/bin/python`, which Apple removed in macOS 12.3 (Spring 2022).
 
-## Build Issues
-At this time, it is required to build this version of python on an Intel macOS device.
+## Apple Silicon Only
+Builds and packages target Apple Silicon (arm64). Universal2 outputs are no longer produced. Build hosts and target machines must be Apple Silicon Macs.
 
-## Why should I use this instead of a package from python.org?
-- It comes with PyObjC and other modules useful for Mac admins pre-installed; making it more like the Apple Python it's intended to replace
-- It installs to a location less likely to be overwritten, removed, or modified by developers or power users who are also working with Python
+## Why use this instead of a package from python.org?
+- Ships with PyObjC and other modules useful for Mac admins, similar in spirit to the Apple Python it replaces
+- Installs to a location less likely to be overwritten, removed, or modified by other Python installations
 
 ## Using interactively
-After installing any of the packages, a symbolic link can be used within terminal for interactive Python sessions. At the time of this writing `/usr/local/bin/managed_python3` points to `/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current/bin/python3`
+After installing the package, `/usr/local/bin/managed_python3` is a symlink to `/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current/Resources/Python.app/Contents/MacOS/Python`.
 
 ## Using with scripts
-It is currently recommended to point directly to symbolic link provided by the Python framework.
-
-At the time of this writing `/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current/bin/python3` points to `/Library/ManagedFrameworks/Python/Python3.framework/Versions/3.8/bin/python3.8`
-
-An example script would look like the following:
+Point your shebang directly at the symlink:
 
 ```
 #!/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current/bin/python3
 
 print('This is an example script.')
 ```
 
-### Other options to consider
-#### zshenv global alias
-If you are calling `python` within `zsh` scripts, adding a global alias to `/etc/zshenv` may be appropriate.
+### zshenv global alias
+For zsh scripts you can add a global alias to `/etc/zshenv`:
 
 `alias -g python3.framework='/Library/ManagedFrameworks/Python/Python3.framework/Versions/Current/bin/python3'`
 
-For more information on this method, please see Armin Briegel's "Moving to Zsh" Part [II](https://scriptingosx.com/2019/06/moving-to-zsh-part-2-configuration-files/) and [IV](https://scriptingosx.com/2019/07/moving-to-zsh-part-4-aliases-and-functions/)
+See Armin Briegel's "Moving to Zsh" Part [II](https://scriptingosx.com/2019/06/moving-to-zsh-part-2-configuration-files/) and [IV](https://scriptingosx.com/2019/07/moving-to-zsh-part-4-aliases-and-functions/).
 
 ## Notes
-To decrease complexity, only a _single_ package may be installed at any given time on a machine.
+Only a single package may be installed at any given time. The preinstall script removes any previous framework.
 
 ### Upgrades
-While Python itself has its own update cadence and dot release schedule, it is likely that this package will have many updates as 3rd party libraries release their own updates, bug fixes and security enhancements. These packages should not break your workflow, but you should test your scripts prior to wide deployment to your devices.
+Python itself has its own release cadence; this package will see additional updates as 3rd-party libraries release fixes and security updates. Always test your scripts before deploying broadly.
 
 ### Downgrades
-Downgrades will not be supported by this repository.
+Not supported.
 
 ### pip
-While `pip` is bundled in this framework, it is **not recommended** to install any external libraries into your frameworks folder outside of what comes with the package. If you need to use or test external libraries not present in the package, it is recommended to use a [virtual environment](https://docs.python.org/3/library/venv.html) or a tool like [pyenv](https://github.com/pyenv/pyenv).
-
-Pull requests can and are encouraged to be issued to the `recommended` packages requirements file.
-
-# Flavors of Python
-We currently offer three versions of Python. You can chose which version suits your needs, however only the `recommended` package is built/signed/notarized.
-
-## No Customization
-This is a Python.framework that contains everything from the official Python package and nothing more.
+`pip` is bundled but **not recommended** for installing external libraries into the framework. Use a [virtual environment](https://docs.python.org/3/library/venv.html) or a tool like [pyenv](https://github.com/pyenv/pyenv) instead. Pull requests to the `recommended` requirements file are welcome.
 
-Many open source tools will not work with this, but it may be helpful for development purposes.
+# Building locally
+Build an unsigned framework on Apple Silicon with:
 
-## Minimal
-This is a Python.framework that includes `xattr` and `PyObjc` - the original intent of [Relocatable Python](https://github.com/gregneagle/relocatable-python).
-
-Tools that should work when using the "Minimal Flavor":
-- [vfuse](https://github.com/chilcote/vfuse)
-- [dockutil](https://github.com/kcrawford/dockutil) (Python 3 pull request [here](https://github.com/kcrawford/dockutil/pull/87))
-- [outset](https://github.com/chilcote/outset)
-
-## Recommended
-This is a Python.framework that contains everything from "Minimal", and a few libraries that various well-known open source projects require.
+```
+./build_python_framework_pkgs.zsh --python-version 3.13.13
+```
 
-Tools that should work when using the "Recommended Flavor":
-- [Autopkg](https://github.com/autopkg/autopkg)
-- [InstallApplications](https://github.com/macadmins/installapplications)
-- [Munki](https://github.com/munki/munki)
-- [munkipkg](https://github.com/munki/munki-pkg)
-- [munki-facts](https://github.com/munki/munki-facts) (python 3 pull request [here](https://github.com/munki/munki-facts/pull/17))
-- [Nudge](https://github.com/macadmins/nudge)
-- [UMAD](https://github.com/macadmins/umad)
+Pass `--installer-id`, `--application-id`, and `--notary-password` to produce a signed and notarized `.pkg`.
 
 # Updating packages
-This should be done in a clean virtual environment. After every Python package install, you can run `pip freeze | xargs pip uninstall -y` to cleanup the environment.
+Do this in a clean virtual environment. After every Python package install, run `pip freeze | xargs pip uninstall -y` to reset the environment.
 
 # CI Job
-To update the certificate, run `base64 -i /path/to/certificate.p12 -o base64string` and import that into the github secrets store and update the password secret as well.
+To update the signing certificate, run `base64 -i /path/to/certificate.p12 -o base64string` and import it into the GitHub Actions secrets store along with the matching password.
 
 # Credits
-These packages are created with two other open source tools:
+Built on two open-source tools by [Greg Neagle](https://www.linkedin.com/in/gregneagle/):
 - [relocatable-python](https://github.com/gregneagle/relocatable-python)
 - [munki-pkg](https://github.com/munki/munki-pkg)
-
-Both are written by [Greg Neagle](https://www.linkedin.com/in/gregneagle/). Thank you for your continued dedication to the macOS platform.