Added explanation for why this microservice was made

DiamondLightSource · OCopping · Mar 23, 2022 · Mar 23, 2022 · Mar 23, 2022 · Mar 24, 2022
commit cce99c97b636db10d03c43b13ffee55412d8e45d
diff --git a/docs/explanations.rst b/docs/explanations.rst
@@ -10,3 +10,4 @@ Explanation of how the library works and why it works that way.
 
     explanations/why-is-something-so
     explanations/why-multiprocessing
+    explanations/why-make-hdf5-reader-service
diff --git a/docs/explanations/why-make-hdf5-reader-service.rst b/docs/explanations/why-make-hdf5-reader-service.rst
@@ -0,0 +1,10 @@
+Why make the HDF5 Reader Service?
+=================================
+
+The HDF5 Reader Service was designed as a replacement to the existing DAWN
+Dataserver for the General Data Aquisition (GDA) system at Diamond Light Source.
+
+The DAWN Dataserver for GDA is a fairly old and hard to maintain data-broker
+service written in Java. It was decided to try and make a much simpler and 
+easier-to-maintain microservice in Python, using REST endpoints for querying 
+instead of hard-coding the logic into GDA.
Original file line number	Diff line number	Diff line change
		@@ -10,3 +10,4 @@ Explanation of how the library works and why it works that way.

		explanations/why-is-something-so
OCopping marked this conversation as resolved. Show resolved Hide resolved
		explanations/why-multiprocessing
		explanations/why-make-hdf5-reader-service