base project

src/home/README.md

@@ -0,0 +1,38 @@
+# Home Page Partials
+
+This directory contains partial HTML files that make up the home page content. Breaking the content into smaller, manageable pieces makes it easier to maintain and update specific sections of the home page.
+
+## Files
+
+1. `home1.html`
+   - Contains the welcome section
+   - Includes the main heading and subtitle
+   - Located at the top of the home page
+
+2. `home2.html`
+   - Contains the features grid section
+   - Displays three feature cards in a responsive grid layout
+   - Located in the main content area
+
+## Usage
+
+These partials are included in `index.html` using HTML comments as markers:
+
+```html
+<!-- Include home1.html -->
+<div id="home1">
+    <!-- @include home/home1.html -->
+</div>
+
+<!-- Include home2.html -->
+<div id="home2">
+    <!-- @include home/home2.html -->
+</div>
+```
+
+## Adding New Sections
+
+To add a new section:
+1. Create a new file (e.g., `home3.html`) in this directory
+2. Add your section content to the file
+3. Include it in `index.html` using the same pattern as above

src/home/img/README.md

@@ -0,0 +1,41 @@
+# Home Page Images
+
+This directory contains images specifically used in the home page sections.
+
+## Directory Structure
+
+```
+home/
+├── img/
+│   ├── hero/         # Images for hero/banner section
+│   ├── features/     # Images for feature cards
+│   └── backgrounds/  # Background images used in home sections
+```
+
+## Usage
+
+When adding images to this directory:
+1. Use descriptive filenames (e.g., `hero-banner.jpg`, `feature1-icon.svg`)
+2. Optimize images for web use
+3. Consider using different sizes for responsive design
+
+## Example
+
+```html
+<!-- In home1.html or home2.html -->
+<img src="home/img/features/feature1-icon.svg" alt="Feature 1">
+```
+
+## Recommended Image Formats
+
+- Use SVG for icons and logos
+- Use WebP or JPEG for photographs
+- Use PNG for images requiring transparency
+- Consider providing multiple sizes for responsive images
+
+## Image Optimization
+
+Before adding images:
+1. Compress them appropriately
+2. Consider providing multiple resolutions for responsive design
+3. Ensure proper aspect ratios are maintained