Update documentation links in various places (#131)

* README: add rtd badge

* update project URLs in various places

* docs: update installation instructions

Author: duncanmmacleod

README.md

@@ -2,7 +2,7 @@ Python utilities and extensions for the Omicron (C++) GW event trigger generator
 
 This package augments the core functionality of the Omicron ETG by providing utilities for building an HTCondor workflow (DAG) to parallelise processing, including segment-selection logic, frame-file discovery, and post-processing.
 
-All credit for the actual Omicron algorithm goes to [Florent Robinet](//github.com/FlorentRobinet/), see [here](http://virgo.in2p3.fr/GWOLLUM/v2r2/index.html?Main) for more details.
+All credit for the actual Omicron algorithm goes to [Florent Robinet](//github.com/FlorentRobinet/), see [here](https://virgo.docs.ligo.org/virgoapp/Omicron/) for more details.
 
 ## Installation
 
@@ -29,6 +29,7 @@ conda install -c conda-forge pyomicron
 
 [![Build status](https://github.com/gwpy/pyomicron/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/gwpy/pyomicron/actions/workflows/build.yml)
 [![codecov](https://codecov.io/gh/gwpy/pyomicron/branch/master/graph/badge.svg)](https://codecov.io/gh/gwpy/pyomicron)
+[![Documentation](https://readthedocs.org/projects/pyomicron/badge/?version=latest)](https://pyomicron.readthedocs.io/en/latest/?badge=latest)
 
 ## License
 

docs/index.rst

@@ -6,16 +6,31 @@
 Welcome to PyOmicron's documentation!
 =====================================
 
-PyOmicron is a workflow generator and processor tool for the `Omicron gravitational-wave event trigger generator <http://virgo.in2p3.fr/GWOLLUM/v2r2/index.html?Main>`_. It was built chiefly to simplify the automatic processing hundreds of data channels recorded by the `Laser Interferometer Gravitational-wave Observatory (LIGO) <http://ligo.org>`_ detectors in order to characterise the instrumental and environmental noises impacting their sensitivity.
+PyOmicron is a workflow generator and processor tool for the `Omicron gravitational-wave event trigger generator <https://virgo.docs.ligo.org/virgoapp/Omicron/>`_. It was built chiefly to simplify the automatic processing hundreds of data channels recorded by the `Laser Interferometer Gravitational-wave Observatory (LIGO) <https://www.ligo.caltech.edu>`_ and `Virgo <https://www.ego-gw.it/>`_ detectors in order to characterise the instrumental and environmental noises impacting their sensitivity.
 
 Installing PyOmicron
 --------------------
 
-The easiest method to install PyOmicron is using `pip <https://pip.pypa.io/en/stable/>`_ directly from the `GitHub repository <https://github.com/ligovirgo/pyomicron.git>`_:
+Installation
+------------
 
-.. code-block:: bash
+PyOmicron can be installed with `conda <https://conda.io`
+(or `Mamba <https://mamba.readthedocs.io/>`_):
 
-   $ pip install git+https://github.com/ligovirgo/pyomicron.git
+.. code-block:: shell
+
+   conda install -c conda-forge pyomicron
+
+or `pip <https://pip.pypa.io>`_:
+
+.. code-block:: shell
+
+   python -m pip install pyomicron
+
+.. warning::
+
+   Omicron (the C++ application) cannot be installed with `pip`, so installing
+   PyOmicron with `conda/mamba` is strongly encouraged.
 
 Documentation
 -------------

omicron/io.py

@@ -60,7 +60,7 @@ def merge_root_files(inputfiles, outputfile,
 
     Notes
     -----
-    This method requires the `ROOT <https://root.cern.ch/pyroot>`_ package.
+    This method requires the `ROOT <https://root.cern.ch/>`_ package.
     """
     import ROOT
     chains = {}