Thanks for flagging the inconsistency, I’ll take a look at aligning them.
The unfortunate truth of Python set up is often visualised by the excellent XKCD illustration.
I have installed/uninstalled/reinstalled Python a handful of times in different ways. I got them all working by hook or by crook … eventually 
The one I have personally had the most success with is the Homebrew and Pyenv approach.
What I might take a go at is putting together a set of instructions based on that to go on the site and then link off to other resources should people have any issues on their system.