initial commit

Control-User-Interfaces/writing-block-json-files.rst

@@ -0,0 +1,13 @@
+.. This is a template top-level index file for a directory in the procedure's arm of the documentation
+
+.. This is the label that can be used as for cross referencing in the given area
+.. Recommended format is "Directory Name"-"Title Name"  -- Spaces should be replaced by hypens
+.. _Writing-BLOCK-JSON-Files:
+
+########################
+Writing BLOCK JSON Files
+########################
+
+This page contains and example of how to convert a Jupyter notebook with an observatory control operation into a SAL Script that can run in the ScriptQueue.
+Having the ability to execute SAL Script via the ScriptQueue is recommended when an operation will be executed either multiple times, in concert with other SAL Scripts, or to make it readily available to others.
+

index.rst

@@ -72,6 +72,21 @@ Users can interface with them either using the :ref:`LOVE interface <Control-Sys
 
     Control-User-Interfaces/writing-sal-scripts.rst
 
+.. _Control-System-User-Interfaces-BLOCK-Execution:
+
+Scheduler-driven BLOCK Execution
+--------------------------------
+
+Users also have the option of executing JSON BLOCKS, which are collections of SAL Scripts and their configurations via the Scheduler.
+BLOCKS are loaded into the Scheduler, and the Scheduler then loads the corresponding scripts to the `ScriptQueue`_.
+
+.. toctree::
+    :maxdepth: 2
+    :titlesonly:
+    :glob:
+
+    Control-User-Interfaces/writing-block-json-files.rst
+
 .. _Control-System-User-Interfaces-Watcher:
 
 Watcher