Update docs

Author: MarcelloPerathoner

doc_src/conf.py

@@ -45,39 +45,39 @@
 
 pic_options = {
     'pic' : {
-        'program'  : ["dpic", "-v"],
-        'align'    : "center",
-        'preamble' : """
+        'program' : ["dpic", "-v"],
+        'align'   : "center",
+        'prolog'  : """
 .PS
 copy "config.pic";
 """,
-        'postamble' : """
+        'epilog' : """
 .PE
 """,
     },
     'uml' : {
-        'program'   : ["plantuml", "-tsvg", "-p"],
-        'align'     : "center",
-        'preamble'  : "@startuml\n",
-        'postamble' : "\n@enduml\n",
+        'program' : ["plantuml", "-tsvg", "-p"],
+        'align'   : "center",
+        'prolog'  : "@startuml\n",
+        'epilog'  : "\n@enduml\n",
     },
     'seq' : {
-        'program'  : ["dpic", "-v"],
-        'align'    : "center",
-        'preamble' : """
+        'program' : ["dpic", "-v"],
+        'align'   : "center",
+        'prolog'  : """
 .PS
 copy "sequence.pic";
 copy "config.pic";
 """,
-        'postamble' : """
+        'epilog' : """
 .PE
 """,
     },
     'dot' : {
-        'program'   : ["dot", "-Tsvg"],
-        'align'     : "center",
-        'preamble'  : "",
-        'postamble' : "",
+        'program' : ["dot", "-Tsvg"],
+        'align'   : "center",
+        'prolog'  : "",
+        'epilog'  : "",
     },
 }
 

doc_src/design.rst

@@ -245,7 +245,7 @@ Duris S 8  GW P9LMS2.EM-NQNS-57S5-0    350  19.8 200 4SMD 0.60     50 RS      87
 For our dome we selected the make: *Osram Duris S8 GW P9LMS1.EM-NSNU-57S5-0*
 mainly because they were comparatively easy to solder by hand.  They come in 5 ×
 5 mm (4SMD) packages, which we then soldered onto postage-stamp sized pieces we
-cut out of a standard 2.54" striped PCB.
+cut out of a standard 2.54mm striped PCB.
 
 .. figure:: ../images/DSC_2886.jpg
    :align: center

doc_src/vibrations.rst

@@ -4,22 +4,22 @@
  Vibration Reduction
 =====================
 
-Camera vibrations caused by mirror movement can reduce sharpness.  The effect is
-the more noticeable the longer the exposure time becomes.  To reduce these
-vibrations use live view or exposure delay mode.
+Camera vibration during exposure reduce sharpness.  The effect gets more noticeable with
+longer exposure times.  To reduce vibrations use a solid tripod to mount the camera.
 
 Single-lens reflex (SLR) cameras use a mirror to deflect the light into the
 viewfinder.  This mirror obscures the sensor and therefore must be lifted before
 the camera can take an exposure.  The lifting of the mirror causes the camera to
-vibrate slightly, even if the camera is mounted on a tripod\ [#]_.
+vibrate slightly, even if the camera is mounted on a tripod\ [#]_.  To reduce
+these vibrations use live view or exposure delay mode.
 
 
 Live View
 =========
 
 In live view mode the camera does not use the viewfinder at all and the mirror
-will be locked in the *up* position.  This mode, when implemented correctly\
-[#]_, can greatly reduce camera vibrations.
+will be locked in the *up* position.  This mode, when implemented correctly\ [#]_,
+can greatly reduce camera vibrations.
 
 Another advantage of live view ist that you can attach a HDMI monitor to your
 camera and preview the picture on a big screen.
@@ -28,22 +28,21 @@ camera and preview the picture on a big screen.
 Exposure Delay Mode
 ===================
 
-Use this mode is live view is not available or broken.  This mode waits 1 second
-after lifting the mirror and before actually taking the picture.  Most of the
-vibration has damped by then.
+Use this mode if live view is not available or broken.  This mode delays taking
+the picture after lifting the mirror until most of the vibrations have damped.
 
-Exposure delay mode does incur a speed penalty but this penalty is less than one
-second per exposure because you must subtract the time it takes the camera to
-write the picture to the memory card.
+Exposure delay mode does incur in a speed penalty but this penalty is small because
+you must also subtract the time it takes the camera to write the picture to the
+memory card.
 
 
 Mirrorless Cameras
 ==================
 
-Mirrorless Interchangeable-Lens Cameras (MILC) do not have a mirror and thus are
-for RTI imaging a suitable alternative to the more common (as of 2018) SLR type.
-The lenses for MILC cameras are not compatible with SLR type lenses and being
-comparatively new the choice of lenses is more limited (but there are adapters).
+Mirrorless Interchangeable-Lens Cameras (MILC) do not have mirrors and thus are
+a suitable alternative to the more common (as of 2018) SLR type.  The lenses for
+MILC cameras as a rule are not compatible with SLR type lenses and, being
+comparatively new, the choice of lenses is more limited (but there are adapters).
 
 
 Footnotes