commit ede2bc6eec8839329003b1b5eb70d62b1d5ebc92 Author: Simone Basso <bassosimone@gmail.com> Date: Mon Jan 30 20:48:41 2017 +0100 Tweak README.md wording (#726) * Tweak README.md wording * Use macOS and change brew link * wrap url in angular brackets * Clarify what happens when you run commands While there, also explain how to run ooniprobe-agent, which is part of what you want to know as a tester / developer. * Tweak previous * Tweak previous again --- README.rst | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index 3de9489b..d2ecac39 100644 --- a/README.rst +++ b/README.rst @@ -86,15 +86,15 @@ Note: You'll need to swap out ``$RELEASE`` for either ``yakkety``, ``xenial`` or ``trusty``. This will not happen automatically. You will also need to ensure that you have the ``universe`` repository enabled. The ``universe`` repository is enabled by default in a standard Ubuntu installation but may not be on some -minimal on not standard installations. +minimal, or not standard, installations. Installation ============ -Mac OS X --------- +macOS +----- -You can install ooniprobe on OSX if you have installed homebrew (http://mxcl.github.io/homebrew) with:: +You can install ooniprobe on macOS if you have installed homebrew (http://brew.sh/) with:: brew install ooniprobe @@ -147,7 +147,7 @@ Configuring ooniprobe --------------------- After successfully installing ooniprobe you should be able to access the web UI -on your host machine at http://localhost:8842/ . +on your host machine at <http://localhost:8842/>. You should now be presented with the web UI setup wizard where you can read the risks involved with running ooniprobe. Upon answering the quiz correctly you can @@ -247,8 +247,17 @@ to be activated:: pip install -r requirements.txt pip install -r requirements-dev.txt python setup.py install - ooniprobe -s # if all went well, lists available tests +Then, you can check whether the installation went well with:: + + ooniprobe -s + +This will explain you the risks of running ooniprobe and make sure you have +understood them, afterwards it shows you the available tests. + +To run the ooniprobe agent, instead, type:: + + ooniprobe-agent run Donate -------