Add a simple intro to M/E.

diff --git a/index.rst b/index.rst
index 08e67d1350d19397efdf8be15bd433a675c4af9f..c34c577e7026c78a2e3230847e4f08f8ae369e16 100644 (file)
--- a/index.rst
+++ b/index.rst
@@ -1,8 +1,3 @@
-.. Nageru documentation master file, created by
-   sphinx-quickstart on Sun Nov  6 23:31:54 2016.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
 Welcome to Nageru's documentation!
 ==================================
 
@@ -11,6 +6,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   meintro
 
 
 Indices and tables

diff --git a/meintro.rst b/meintro.rst
new file mode 100644 (file)
index 0000000..0fa2822
--- /dev/null
+++ b/meintro.rst
@@ -0,0 +1,26 @@
+Introduction to the M/E workflow
+================================
+
+Nageru, like most hardware video mixers, is based on the **mixer/effects**
+workflow, or just M/E for short. (Don't ask why “mixer” or “effects”;
+the name is confusing and mostly historical.)
+
+The basic idea of M/E is that you have two main displays, *preview* and *live*.
+Every time you want to change what's shown to the viewer, you first bring it
+up on the preview display, verify that it indeed contains something you'd like
+to show to your viewers, and only then start a transition to move the preview
+display onto the live display (which mirrors exactly what the viewers see).
+After the transition is done, the preview and live displays switch, allowing
+the operator to either switch back or to pull a new source onto the preview
+display.
+
+In Nageru, the available transitions at any time are governed by the
+:doc:`theme </theme>`. However, generally a simple cut (moving immediately
+from live to preview) will nearly always be an option. Other effects include
+fades and zooms, but availability will depend on what sources are involved in the
+transition.
+
+The mixer can be controlled by the mouse or keyboard, but most operators will prefer using both hands
+on the keyboard. Like on a real mixing console, you use your left hand to select
+sources for preview (using the 1–9 keys) and the right hand to choose a transition
+(using H, J or K).