Merge pull request #19 from bruceravel/master

document unfinished controls work and expand acknowledgements

Author: bruceravel

docs/details.rst

@@ -199,6 +199,44 @@ the in-hutch patch panel.
    :width: 100%
    :align: center
 
+
+Controls chores, unfinished
+---------------------------
+
+This is a list of things that never got done back in 2017-2018.  For
+the most part, none of these are a problem in any way.  The beamline
+operates just fine without these.  This section is simply an effort to
+capture these for posterity.
+
++ PI piezo controllers on ``dcm.pitch``, ``m2.pitch``, and
+  ``m3.pitch``. Some primitive controls are in place.  There is a box
+  on the BMM CSS Main Page for piezo controls.  But active feedback
+  was never developed for any of these three items. It is not hard to
+  imagine the ways that having active feedback might be helpful, but
+  these are not currently available.
+
+* Fully fleshed out trigonometry for M2 and M3.  This would include
+  careful calibration of distances.
+
+* Photon delivery system mode B.  This is the low energy, focused
+  mode.  The last time I looked at this, it seemed that the hard
+  limits on the M3 downstream axes were set just a bit too high.  It
+  is also not clear whether the XAS table can go low enough for this
+  delivery mode.
+
+* The VME crate is plugged into an unmaganged switch, which is then
+  plugged into the managed switch.  This is silly and unnecessary, but
+  has never been enough of a problem to fix.
+
+* The outlets in the FOE should be moved to the insides of the blue
+  stand to avoid having plugs get kicked when people are moving around
+  the back alley.  This seems expensive and not completely necessary,
+  but sure would be nice.
+
+* Encoder pizza box in Rack A is unconfingured.  It will likely never
+  get used.
+
+
 DCM 1st Xtal Equilibration
 --------------------------
 
@@ -255,8 +293,8 @@ delivery to the mono and the filter assemblies.
    found.  (Middle) A view into the FOE.  (Right) The inboard wall
    where the physical valve is found.
 
-Disabling an MCS8 axis after a move
------------------------------------
+Disabling MCS8 axes after move
+------------------------------
 
 From Adam Young at FMBO
 ~~~~~~~~~~~~~~~~~~~~~~~

docs/intro.rst

@@ -412,23 +412,20 @@ about 300 |mu| m by 250 |mu| m.
 Acknowledgements
 ----------------
 
-This documentation project uses `Sphinx
-<https://www.sphinx-doc.org/en/master/index.html>`__ and the lovely
-`{book}theme
-<https://sphinx-book-theme.readthedocs.io/en/latest/index.html>`__
-from the `The Executable Book Project
-<https://ebp.jupyterbook.org/>`__.  Appendices are numbered properly
-using the ``appendix.py`` extension from
-https://github.com/heig-tin-info/handout.
+Pride of place goes to the late Jimmy Biancarosa and to Don Abel, the
+excellent technicians who helped build BMM and outfit it with kit
+that works.  Truly nothing would have ever happened at BMM without them.
 
 BMM's `Bluesky <https://blueskyproject.io/>`__ profile was mostly
 written by Bruce.  But this would not have happened without the help
 of several members of NSLS-II's DSSI program.  In particular, I want
 to thank Dan Allan, Tom Caswell, Josh Lynch, Jakub Wlodek, Max
 Rakitin, Dmitri Gavrilov, Stuart Campbell, Abby Giles, Garrett Bishof,
-Nate Maytan, Matt Snyder, Oksana Ivashkevych, and Ryan Jaskiel.  And I
-need to thank every BMM user |nd| being a BMM user means being a beta
-tester for the beamline software!
+Nate Maytan, Matt Snyder, Oksana Ivashkevych, Ryan Jaskiel, AJ Sliger,
+and Jun Ma.  
+
+Thanks to every BMM user |nd| being a BMM user means being a beta tester
+for the beamline software!
 
 BMM makes use of `lots of great python tools
 <https://speakerdeck.com/jakevdp/the-unexpected-effectiveness-of-python-in-science?slide=52>`__.
@@ -437,6 +434,15 @@ to process every XAS scan that gets measured and Matt's `lmfit
 <https://lmfit.github.io/lmfit-py/>`__ is used for many alignment
 chores.
 
+This documentation project uses `Sphinx
+<https://www.sphinx-doc.org/en/master/index.html>`__ and the lovely
+`{book}theme
+<https://sphinx-book-theme.readthedocs.io/en/latest/index.html>`__
+from the `The Executable Book Project
+<https://ebp.jupyterbook.org/>`__.  Appendices are numbered properly
+using the ``appendix.py`` extension from
+https://github.com/heig-tin-info/handout.
+
 This manual uses a GitHub action to build and deploy `(see details
 here)
 <https://github.com/marketplace/actions/sphinx-docs-to-github-pages>`__
@@ -446,6 +452,7 @@ developers for this continuous deployment capability.
 
 
 
+
 A note about copyright
 ----------------------