Merge pull request #7 from CU-ESIIL/codex/fix-homepage-and-examples-components-in-mkdocs

Fix homepage and examples rendering in standard MkDocs Material setup

Author: ttuff

docs/examples.md

@@ -1,15 +1,15 @@
 # UI Examples
 
-This page contains small, copyable patterns you can reuse across the site.
+This page contains small, copyable patterns that are compatible with a standard MkDocs + Material setup.
 
 ## Hoverable button
 
 Use this for a small call-to-action with a subtle hover effect.
 
-<a class="md-button oasis-hover-button" href="#">Example hover button</a>
+[Back to Home](index.md){ .md-button .oasis-hover-button }
 
-```html
-<a class="md-button oasis-hover-button" href="#">Example hover button</a>
+```md
+[Back to Home](index.md){ .md-button .oasis-hover-button }
 ```
 
 ## Responsive iframe embed
@@ -18,7 +18,7 @@ Use this wrapper to keep embedded content responsive.
 
 <div class="oasis-embed">
   <iframe
-    title="Example map embed"
+    title="OpenStreetMap example embed"
     src="https://www.openstreetmap.org/export/embed.html?bbox=-105.3%2C39.9%2C-104.9%2C40.1&amp;layer=mapnik"
     loading="lazy"
     allowfullscreen>
@@ -28,8 +28,8 @@ Use this wrapper to keep embedded content responsive.
 ```html
 <div class="oasis-embed">
   <iframe
-    title="Example embed"
-    src="https://example.com"
+    title="OpenStreetMap example embed"
+    src="https://www.openstreetmap.org/export/embed.html?bbox=-105.3%2C39.9%2C-104.9%2C40.1&amp;layer=mapnik"
     loading="lazy"
     allowfullscreen>
   </iframe>

docs/index.md

@@ -1,31 +1,31 @@
 # basic_OASIS
 
-Welcome to `basic_OASIS`, a lightweight documentation starter built with MkDocs + Material. Use this as a clean baseline for project notes, quick guides, and student-facing documentation.
+`basic_OASIS` is a lightweight MkDocs + Material starter for clear project documentation. It is designed to stay minimal, readable, and easy to extend.
 
-[Get Started](examples.md){ .md-button .md-button--primary }
+[Explore Examples](examples.md){ .md-button .md-button--primary }
 [View Repository](https://github.com/CU-ESIIL/basic_OASIS){ .md-button }
 
 <div class="grid cards" markdown>
 
-- :material-code-tags: **Code**
+- **Code**
 
   ---
 
-  Keep setup steps, scripts, and reproducible snippets in one place.
+  Capture setup steps, scripts, and reproducible snippets in one place.
 
-- :material-database: **Data**
+- **Data**
 
   ---
 
-  Share data access notes, schemas, and provenance details clearly.
+  Document data access, formats, and provenance so work stays transparent.
 
-- :material-file-document-outline: **Docs**
+- **Docs**
 
   ---
 
-  Build concise guides that are easy to maintain and extend over time.
+  Write concise guides that future contributors can quickly understand.
 
 </div>
 
 !!! note "Template-first by design"
-    This site is intentionally minimal. Treat it as a starter template and extend only what your project needs.
+    This site is intentionally minimal. Start simple, then extend only what your project needs.