🚸 improve UI and add guide

Signed-off-by: peter szemraj <[email protected]>

app.py

@@ -307,12 +307,15 @@ if __name__ == "__main__":
     with demo:
         gr.Markdown("# Document Summarization with Long-Document Transformers")
         gr.Markdown(
-            "This is an example use case for fine-tuned long document transformers. The model is trained on book summaries (via the BookSum dataset). The models in this demo are [LongT5-base](https://huggingface.co/pszemraj/long-t5-tglobal-base-16384-book-summary) and [Pegasus-X-Large](https://huggingface.co/pszemraj/pegasus-x-large-book-summary)."
+            "An example use case for fine-tuned long document transformers. Model(s) are trained on [book summaries](https://huggingface.co/datasets/kmfoda/booksum). Architectures in this demo are [LongT5-base](https://huggingface.co/pszemraj/long-t5-tglobal-base-16384-book-summary) and [Pegasus-X-Large](https://huggingface.co/pszemraj/pegasus-x-large-book-summary)."
         )
         with gr.Column():
             gr.Markdown("## Load Inputs & Select Parameters")
             gr.Markdown(
-                "Enter text below in the text area. The text will be summarized [using the selected parameters](https://huggingface.co/blog/how-to-generate). Optionally load an example below or upload a file. (`.txt` or `.pdf` - _[link to guide](https://i.imgur.com/c6Cs9ly.png)_)"
+                """Enter/paste text below, or upload a file. Pick a model & adjust params (_optional_), and press **Summarize!**
+
+                See [the guide doc](https://gist.github.com/pszemraj/722a7ba443aa3a671b02d87038375519) for details.
+                """
             )
             with gr.Row(variant="compact"):
                 with gr.Column(scale=0.5, variant="compact"):
@@ -353,22 +356,20 @@ if __name__ == "__main__":
         with gr.Column():
             gr.Markdown("## Generate Summary")
             gr.Markdown(
-                "Summarization should take ~1-2 minutes for most settings, but may extend up to 5-10 minutes in some scenarios."
+                "_Summarization should take ~1-2 minutes for most settings, but may extend up to 5-10 minutes in some scenarios._"
             )
             summarize_button = gr.Button(
                 "Summarize!",
                 variant="primary",
             )
-
             output_text = gr.HTML("<p><em>Output will appear below:</em></p>")
-            gr.Markdown("### **Summary Output**")
-            summary_text = gr.HTML(
-                label="Summary", value="<i>Summary will appear here!</i>"
-            )
             with gr.Column():
-                gr.Markdown("#### Export & Summary Scores")
+                gr.Markdown("#### Results & Scores")
                 with gr.Row():
                     with gr.Column(variant="compact"):
+                        gr.Markdown(
+                            "Download the summary as a text file, with parameters and scores."
+                        )
                         text_file = gr.File(
                             label="Download as Text File",
                             file_count="single",
@@ -384,9 +385,16 @@ if __name__ == "__main__":
                             placeholder="Summary scores will appear here",
                         )
 
+            gr.Markdown("#### **Summary Output**")
+            summary_text = gr.HTML(
+                label="Summary", value="<i>Summary will appear here!</i>"
+            )
         gr.Markdown("---")
         with gr.Column():
             gr.Markdown("### Advanced Settings")
+            gr.Markdown(
+                "Refer to [the guide doc](https://gist.github.com/pszemraj/722a7ba443aa3a671b02d87038375519) for what these are, and how they impact _quality_ and _speed_."
+            )
             with gr.Row(variant="compact"):
                 length_penalty = gr.Slider(
                     minimum=0.5,