From 7fa346fbb77aa9ddd07bcac34d599c94212e57f5 Mon Sep 17 00:00:00 2001
From: James McKinney <26463+jpmckinney@users.noreply.github.com>
Date: Thu, 28 Mar 2024 11:24:25 -0400
Subject: [PATCH] docs: Mention Homebrew install

---
 docs/contributing.rst               |  8 +-------
 docs/tricks.rst                     |  8 ++++----
 docs/tutorial/1_getting_started.rst | 16 ++++++++++------
 3 files changed, 15 insertions(+), 17 deletions(-)

diff --git a/docs/contributing.rst b/docs/contributing.rst
index f3419e4cb..b16825ff9 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -8,21 +8,15 @@ We seek contributions from developers and non-developers of all skill levels. We
 
 Before making any changes or additions to csvkit, please be sure to read the rest of this document, especially the "Principles of development" section.
 
-Getting Started
+Getting started
 ===============
 
-Set up your environment for development:
-
 .. code-block:: bash
 
    git clone git://github.com/wireservice/csvkit.git
    cd csvkit
-   mkvirtualenv csvkit
-
    pip install -e .[test]
 
-   python setup.py develop
-
 Principles of development
 =========================
 
diff --git a/docs/tricks.rst b/docs/tricks.rst
index 4e0c42b02..c198227b1 100644
--- a/docs/tricks.rst
+++ b/docs/tricks.rst
@@ -54,21 +54,21 @@ Processes running in a crontab `will not have a tty allocated <https://github.co
    # works fine 
    0 0 * * * /usr/bin/csvsql --query 'select max(time) from temp' -d ';' --tables temp < /my/csv/file.csv
 
+.. _troubleshooting:
+
 Troubleshooting
 ===============
 
 Installation
 ------------
 
-csvkit is supported on non-end-of-life versions of Python.
-
-It is tested on macOS, and has also been used on Linux and Windows.
+csvkit is supported on non-end-of-life versions of Python on Linux, macOS and Windows.
 
 If installing on macOS, you may need to install Homebrew first:
 
 .. code-block:: bash
 
-   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew install python
    pip install csvkit
 
diff --git a/docs/tutorial/1_getting_started.rst b/docs/tutorial/1_getting_started.rst
index 8c90d0e1c..3b3597e5d 100644
--- a/docs/tutorial/1_getting_started.rst
+++ b/docs/tutorial/1_getting_started.rst
@@ -14,23 +14,27 @@ This tutorial assumes you have some basic familiarity with the command line. If
 Installing csvkit
 =================
 
-Installing csvkit is easy:
+.. note::
+
+   It's best to install csvkit in a `virtual environment <https://docs.python.org/3/library/venv.html>`_.
 
 .. code-block:: bash
 
-   sudo pip install csvkit
+   pip install csvkit
 
-If you have problems installing, look for help  in the :doc:`../tricks` section of the documentation.
+Not working? Check :ref:`troubleshooting`.
 
 If you need to work with `Zstandard <https://facebook.github.io/zstd/>`_ files with the ``.zst`` extension, install Zstandard support:
 
 .. code-block:: bash
 
-   sudo pip install csvkit[zstandard]
+   pip install csvkit[zstandard]
 
-.. note::
+Do you use Homebrew? You can `install csvkit system-wide <https://formulae.brew.sh/formula/csvkit>`_ with:
+
+.. code-block:: bash
 
-   If you're familiar with `virtualenv <https://virtualenv.readthedocs.org/en/latest/>`_, it is better to install csvkit in its own environment. If you are doing this, then you should leave off the ``sudo`` in the previous command.
+   brew install csvkit
 
 Getting the data
 ================