doc editing

docs/deploy-development-rp.md

@@ -8,8 +8,10 @@
    you don't have one installed already.  The `az` client supports Python 2.7
    and Python 3.5+.  A recent Python 3.x version is recommended.
 
-1. Install the `gpgme-devel`and `libassuan-devel` packages.
-  > MacOSX user please check the [prepare-osx-devbox.md](./prepare-osx-devbox.md) documentation
+1. Fedora users: install the `gpgme-devel` and `libassuan-devel` packages.
+
+   OSX users: please follow [Prepare your development environment using
+   OSX](./prepare-your-development-environment-using-osx.md).
 
 1. Install the [Azure
    CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli), if you

docs/prepare-your-development-environment-using-osx.md

@@ -1,14 +1,14 @@
-# Prepare your development environment using MacOS X
+# Prepare your development environment using OSX
 
-We are open to developers on OSX working on this repository. We are asking
- macOS users to setup GNU utils on their machines.
+We are open to developers on OSX working on this repository.  We are asking OSX
+users to setup GNU utils on their machines.
 
 We are aiming to limit the amount of shell scripting, etc. in the repository,
 installing the GNU utils on OSX will minimise the chances of unexpected
-differences in command line flags, usages, etc., and make it easier for
-everyone to ensure compatibility down the line.
+differences in command line flags, usages, etc., and make it easier for everyone
+to ensure compatibility down the line.
 
-## Guidances
+## Guidance
 
 ```bash
 # GNU Utils