improve description

app.py

@@ -250,26 +250,47 @@ def open_prs(profile: gr.OAuthProfile | None, user_or_org: str = None):
     return f"Opened {len([r for r in results if r['opened_pr']])} PRs"
 
 
-description_text = """
-## Welcome to the Librarian Bot Metadata Request Service
+# description_text = """
+# ## Welcome to the Librarian Bot Metadata Request Service
 
-⭐ The Librarian Bot Metadata Request Service allows you to request metadata updates for your models on the Hugging Face Hub. ⭐
+# ⭐ The Librarian Bot Metadata Request Service allows you to request metadata updates for your models on the Hugging Face Hub. ⭐
 
-Currently this app allows you to request for librarian bot to add metadata for the `base_model` field, situated in the `YAML` block of your model's `README.md`.
+# Currently this app allows you to request for librarian bot to add metadata for the `base_model` field, situated in the `YAML` block of your model's `README.md`.
 
-### How does librarian bot find this information? 
+# This app will allow you to request metadata for all your models or for another user or org. If you request metadata for another user or org, librarian bot will randomly select 5 models to request metadata for.
 
-We performed a regular expression match on your `README.md` file to determine the connection.
 
-### Why add this info to Model Cards?
+# ### How does librarian bot know what metadata to add to your model card? 
 
-Enhancing your model's metadata in this way:
-- **Boosts Discoverability** - It becomes straightforward to trace the relationships between various models on the Hugging Face Hub.
-- **Highlights Impact** - It showcases the contributions and influences different models have within the community.
+# Librarian bot will perform a regular expression match on your `README.md` file to determine whether your model may have bene fine-tuned from another model. This model is known as the `base_model`.
 
-For a hands-on example of how such metadata can play a pivotal role in mapping model connections, take a look at [librarian-bots/base_model_explorer](https://huggingface.co/spaces/librarian-bots/base_model_explorer).
+# ### Why add this info to Model Cards?
+
+# Enhancing your model's metadata in this way:
+# - 🚀 **Boosts Discoverability** - It becomes straightforward to trace the relationships between various models on the Hugging Face Hub.
+# - 🏆**Highlights Impact** - It showcases the contributions and influences different models have within the community.
+
+# For a hands-on example of how such metadata can play a pivotal role in mapping model connections, take a look at [librarian-bots/base_model_explorer](https://huggingface.co/spaces/librarian-bots/base_model_explorer).
+
+# """
+
+description_text = """
+## Enhance Your Model's Metadata with Librarian Bot! 
 
-This app will allow you to request metadata for all your models or for another user or org. If you request metadata for another user or org, librarian bot will randomly select 5 models to request metadata for.
+Welcome to the Librarian Bot Metadata Request Service. With a few clicks, enrich your Hugging Face models with key metadata!
+
+🎯 **Purpose of this App**
+- Request metadata updates for your models on the Hugging Face Hub, specifically to add or update the `base_model` field in the `YAML` section of your model's `README.md`.
+- Optionally, request metadata for models belonging to another user or organization. If doing so, the bot will randomly pick 5 models for metadata addition.
+
+🤖 **How Does Librarian Bot Determine Metadata?**
+- It scans your `README.md` to try to determine if your model has been fine-tuned from another model. This original model is identified as the `base_model`.
+
+🚀 **Benefits of Metadata Enhancement**
+- **Boosts Discoverability**: Easier tracing of relationships between Hugging Face Hub models.
+- **Highlights Impact**: Demonstrates the influence and contribution of different models.
+
+💡 Explore the [librarian-bots/base_model_explorer](https://huggingface.co/spaces/librarian-bots/base_model_explorer) for a hands-on look at the significance of this `base_model` metadata.
 """
 
 
@@ -281,12 +302,22 @@ with gr.Blocks() as demo:
         """<div style='text-align:center;'><img src='https://huggingface.co/spaces/davanstrien/librarian_bot_request_metadata/resolve/main/image.png' style='display:block;margin-left:auto;margin-right:auto;width:150px;'></div><p>"""
     )
     gr.Markdown(description_text)
+
     with gr.Row():
-        gr.Markdown('### Select a user or org to open PRs for (leave blank to open PRs for all your own models)')
+        gr.Markdown(
+            """
+        ## How to Use the Librarian Bot Metadata Request Service
+
+        1. **Login to Hugging Face**: Use the login button below to sign in. If you don't have an account, [create one here](https://huggingface.co/join).
+        2. **Specify Target User/Organization**: Enter a username or organization name if you wish the Librarian Bot to search metadata for someone other than yourself. Leaving this blank will prompt the bot to look for metadata for your own models and make PRs when a match is found.
+        3. **Initiate Metadata Enhancement**: Click the "Open Pull Requests" button. The bot will then search for `base_model` metadata and create Pull Requests for models lacking this information."""
+        )
     with gr.Row():
         gr.LoginButton()
         gr.LogoutButton()
-        user = gr.Textbox(value=None, label="(Optional) user or org to open pull requests for")
+        user = gr.Textbox(
+            value=None, label="(Optional) user or org to open pull requests for"
+        )
     button = gr.Button(value="Open Pull Requests")
     results = gr.Markdown()
     button.click(open_prs, [user], results)