From 84ab46ada4b19563523b6194427f688c5eb17c29 Mon Sep 17 00:00:00 2001
From: Jan David Mol <mol@astron.nl>
Date: Thu, 7 Oct 2021 23:03:04 +0200
Subject: [PATCH] L2SS-434: Add intro
---
docs/source/index.rst | 4 ++++
docs/source/interfaces/control.rst | 2 +-
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 2551b0f53..fbd729ed1 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -6,6 +6,10 @@
Welcome to LOFAR2.0 Station Control's documentation!
====================================================
+LOFAR2.0 Station Control is a software stack aimed to monitor, control, and manage a LOFAR2.0 station. In order to do so, it whips up a series of Docker containers, and combines the power of `Tango Controls <https://www.tango-controls.org/>`_, `PyTango <https://pytango.readthedocs.io/en/stable/>`_, `Docker <https://www.docker.com/>`_, `Grafana <https://grafana.com/>`_, `ELK <https://www.elastic.co/what-is/elk-stack>`_, `Jupyter Notebook <https://jupyter.org/>`_, and many others to provide a rich and powerful experience in using the station.
+
+Full monitoring and control access to the LOFAR2.0 station hardware is provided, by marshalling their rich `OPC-UA <https://opcfoundation.org/about/opc-technologies/opc-ua/>`_ interfaces. Higher-level logic makes it possible to easily configure and obtain the LOFAR station data products (beamlets, XSTs, SSTs, BSTs) from your local machine using Python, or through one of our provided web interfaces.
+
.. toctree::
:maxdepth: 2
:caption: Contents:
diff --git a/docs/source/interfaces/control.rst b/docs/source/interfaces/control.rst
index 7aa8b90b6..3c514f11d 100644
--- a/docs/source/interfaces/control.rst
+++ b/docs/source/interfaces/control.rst
@@ -1,7 +1,7 @@
Monitoring & Control
========================
-The main API to control the station is through the `Tango Controls <https://tango-controls.readthedocs.io/en/latest/>`_ API we expose on port 10000, which is most easily accessed using a `PyTango <https://pytango.readthedocs.io/en/stable/client_api/index.html>`_ client.
+The main API to control the station is through the `Tango Controls <https://tango-controls.readthedocs.io/en/latest/>`_ API we expose on port 10000, which is most easily accessed using a `PyTango <https://pytango.readthedocs.io/en/stable/client_api/index.html>`_ client. The Jupyter Notebook installation we provide is such a client.
.. _jupyter:
--
GitLab