Add further clarification and refine description of project

include note on experiences with debugging using Gemini

Author: egrace479

README.md

@@ -1,42 +1,45 @@
 # Imageomics Catalog
 
-Repository for Imageomics data, model, spaces, and code catalog.
+Repository for web-based Imageomics data, model, spaces, and code catalog. This catalog is designed to use the Hugging Face API for searching all dataset, model, and spaces repositories created under the [Imageomics Hugging Face Organization](https://huggingface.co/imageomics). Code integration through the GitHub API is the next stage of development.
 
 This project was initialized with the help of Gemini 2.5, accessed [through OSU](https://ai.osu.edu/faculty-staff-students/approved-ai-tools). In addition to speeding up the development of this site, I was curious about how much Gemini could do and where it would falter; see the [full prompt/discussion](catalog-generation-prompt-Gemini2.5Flash.md) for more information.
 
-# Project Description from Gemini:
+## Features
 
-## Imageomics Hugging Face Catalog
+The website is styled using the [tailwindcss](https://tailwindcss.com/) pacakge.
 
-This is a web-based catalog designed to explore public datasets, models, and spaces from the Hugging Face Hub, specifically for the Imageomics organization.
+* **Real-time Data Fetching:** Displays all public Imageomics repositories directly from the Hugging Face API. Includes a "New" badge for products created within the last 30 days.
+* **Search Functionality:** Quickly find items by keyword.
+* **Filtering:** Filter by repository type (Datasets, Models, Spaces) and tags.
+* **Sorting:** Sort items by last updated, date created, or alphabetically.
+* **Responsive Design:** The layout is optimized for use on computers and mobile devices.
+* **Thematic Styling:** Uses Imageomics color scheme for a cohesive look and feel.
+* **Longevity:** This site is run through GitHub Pages, ensuring continued access through GitHub without needing to otherwise provision dedicated infrastructure.
 
-The application is built using a modern, modularized approach with a clean, responsive design.
+## Project Structure
 
-### Features
+The site runs based on three primary files:
 
-* **Real-time Data Fetching:** Displays the latest public repositories directly from the Hugging Face API.  
-* **Search Functionality:** Quickly find items by keyword.  
-* **Filtering:** Filter by repository type (Datasets, Models, Spaces) and tags.  
-* **Sorting:** Sort items by last updated, date created, or alphabetically.  
-* **Responsive Design:** The layout is optimized for viewing on all devices, from mobile phones to desktops.  
-* **Thematic Styling:** Styled with Imageomics' official brand colors for a cohesive look and feel.
+* `index.html`: The main HTML file that provides the structure of the webpage and links to the CSS and JavaScript files, though it still has some manual color/style definitions.
+* `style.css`: Custom styling for the application, including color schemes, layout, and animations. 
+    * **Note:** Color defined in `index.html` for specific portions of the site will overwrite those defined in this file.
+* `main.js`: Handles the application's logic, including API calls, data filtering, sorting, and dynamic rendering of the catalog items.
+    * **Note:** Model API calls do ***not*** return `cardData` unless explicitly fetched _by model_, so there is extra logic required to fetch Model metadata. This was not accounted for until [commit a8d3000](https://github.com/Imageomics/catalog/commit/a8d30009f58a11e708f36d54b9bf4a228bdf1538), as it took updates related to issue #3 to discover.
 
-### File Structure
+## Local Testing
 
-The project has been refactored into three separate files for improved organization and maintainability:
-
-* `index.html`: The main HTML file that provides the structure of the webpage and links to the CSS and JavaScript files.  
-* `style.css`: Contains all the custom styling for the application, including color schemes, layout, and animations.  
-* `main.js`: Handles all the application's logic, including API calls, data filtering, sorting, and dynamic rendering of the catalog items.
-
-### How to Run
-
-For local testing, run
+In the repo root, run
 
 ```console
 python -m http.server 8080
 ```
 
 Then open <http://[::]:8080/> in your browser of choice.
 
-For hosting on a platform like GitHub Pages, you just need to upload these three files to your repository and enable the Pages feature.
+## Note on Debugging with Gemini
+
+It is important to provide the relevant code and preface with something along the lines of:
+
+> Based on this project, without changing the structure of existing code more than necessary for efficient design, can you identify...
+
+Then ask for a plan of how to reolve the issue. In my debugging experience, it did not demonstrate the ability to recognize or distinguish between a fix of "robustness" to handle outliers (which already existed at the precise location to which it pointed) and actually fixing the code to get the information that should have been fetched. Additionally, it has a tendency to rewrite an entire function and forget about tasks that are done in that function that are not _directly_ related to the bug it is attempting to fix.