JOSS Feedback - Readme clarification (#15)

Signed-off-by: Andrew Sedler <[email protected]>
Co-authored-by: Andrew Sedler <[email protected]>

README.md

@@ -4,7 +4,16 @@
 
 ## Introduction
 
-This repository provides a set of solutions for running [AutoLFADS](https:/snel-repo/autolfads-tf2/tree/main/lfads-tf2) in different compute environments and workflows. Use the solution matrix as a rough guide for identifying an suitable workflow:
+This repository provides a set of solutions for running [AutoLFADS](https:/snel-repo/autolfads-tf2/tree/main/lfads-tf2) in a wider variety of compute environments. This enables more users to take better advantage of the hardware available to them to perform computationally demanding hyperparameter sweeps.
+
+![](paper/solutions.png)
+
+We provide three options for different cluster configurations and encourage the user to select the one that best suits their needs:
+- _Local Compute_: users directly leverage a container image that bundles all the AutoLFADS software dependencies and provides an entrypoint directly to the LFADS package. Interactivity with this workflow is provided via YAML model configuration files and command line arguments.
+- _Unmanaged Compute (Ray)_: users configure a Ray cluster and interact with the workflow by updating YAML model configurations, updating hyperparameter sweep scripts, and then running experiment code.
+- _Managed Compute (KubeFlow)_: users interact with a KubeFlow service by providing an experiment specification that includes model configuration and hyperparameter sweep specifications either as a YAML file or using a code-less UI-based workflow.
+
+The solution matrix below provides a rough guide for identifying an suitable workflow:
 
 | | Local Container | Ray | KubeFlow |
 |---------------------------------------------------|-----------------|-----------|---------------|
@@ -14,7 +23,7 @@ This repository provides a set of solutions for running [AutoLFADS](https://gith
 | Infrastructure | Local | Unmanaged | Managed/Cloud |
 | Cost | $ | $ - $$ | $ - $$$ |
 
-
+> Details describing the AutoLFADS solutions and evaluation against the Neural Latents Benchmark datasets can be found in our [paper](paper/paper.pdf).
 
 ## Installation & Usage