docs: import Wiki docs into the main repo

1 files changed, 39 insertions, 0 deletions

diff --git a/docs/installation_instructions_for_macos.md b/docs/installation_instructions_for_macos.md
new file mode 100644
index 00000000..216e042d
--- /dev/null
+++ b/docs/installation_instructions_for_macos.md
@@ -0,0 +1,39 @@
+# Installation instructions for macOS
+
+LuaRocks is a command-line tool. You can install LuaRocks using one of the
+third-party package managers available for macOS (formerly known as "Mac OS X"
+or "OS X"), or you may install it manually, in the Unix way.
+
+# Option 1: using Homebrew 
+
+One option is to use [Homebrew](https://brew.sh). If you don't have it
+installed, follow its installation instructions.
+
+If you already have it installed, make sure it is up to date so you pick the
+most recent version of LuaRocks:
+
+```
+brew update
+```
+
+and then install LuaRocks:
+
+```
+  brew install luarocks
+```
+
+# Option 2: installing it manually 
+
+If you do not wish to use a package management tool to install LuaRocks, you
+can install it on macOS as you would do in any other Unix system, assuming you
+have the Mac Developer Tools installed. Download the Unix tarball and then
+follow the [installation instructions for
+Unix](installation_instructions_for_unix.md) to install it to /usr/local.
+
+# Next steps 
+
+Once LuaRocks is installed, learn more about [using
+LuaRocks](using_luarocks.md).
+
+
+