chore: adds documentation site and SEO improvements

Initializes a documentation site for the project, including essential files such as HTML, robots.txt, and sitemap.xml.

Implements several SEO enhancements, including meta tags, crawler configurations, and AI reference guides, to improve discoverability across search engines and developer communities.

Author: wendellmva

site/OG-IMAGE-GUIDE.md

@@ -0,0 +1,128 @@
+# Creating Your Social Preview Image (og-image.png)
+
+## Requirements
+- **Dimensions**: 1200 x 630 pixels
+- **Format**: PNG or JPG
+- **File size**: < 5MB (ideally < 300KB)
+- **Location**: `site/public/og-image.png`
+
+## Design Recommendations
+
+### Layout
+```
+???????????????????????????????????????????????????
+?                                                 ?
+?  [Logo]  FactoryTools                          ?
+?                                                 ?
+?  Lightweight .NET Template Engine               ?
+?                                                 ?
+?  • Code Generation                              ?
+?  • Data Composition                             ?
+?  • Zero Dependencies                            ?
+?                                                 ?
+?  ? Simpler than Razor                         ?
+?  ? Faster than T4                             ?
+?                                                 ?
+?  tools.lowlandtech.com                          ?
+?                                                 ?
+???????????????????????????????????????????????????
+```
+
+### Design Elements
+1. **Background**: Clean gradient or solid color (#0ea5e9 brand blue)
+2. **Logo**: Your wrench.svg icon (large, left side)
+3. **Title**: "FactoryTools" in large, bold font
+4. **Subtitle**: "Lightweight .NET Template Engine"
+5. **Key Points**: 2-3 bullet points or icons
+6. **CTA/URL**: "tools.lowlandtech.com" at bottom
+7. **Code Snippet** (optional): Small example showing ${...} syntax
+
+### Tools for Creation
+- **Canva**: canva.com (easy, templates available)
+- **Figma**: figma.com (professional, free tier)
+- **Photoshop/GIMP**: For full control
+- **Placid.app**: Automated OG image generation
+- **Cloudinary**: Dynamic OG images
+
+### Quick Canva Template
+1. Go to Canva
+2. Search "Facebook Post" (1200x630)
+3. Use this design:
+   - Background: Gradient (#0ea5e9 to #0284c7)
+   - Add your wrench icon
+   - Title: "FactoryTools" (72pt, Bold)
+   - Subtitle: "Lightweight .NET Template Engine" (36pt)
+   - Bullet points: (24pt)
+     - "? Simpler than Razor"
+     - "? Zero Dependencies"  
+     - "?? Built for Code Generation"
+   - Footer: "tools.lowlandtech.com" (20pt)
+
+### Example Code Snippet (Optional)
+```csharp
+var template = @"
+Hello, ${Name}!
+@if (IsAdmin) {
+  Welcome, admin!
+}";
+```
+
+### Color Palette
+- **Primary Blue**: #0ea5e9 (Cyan 500)
+- **Dark Blue**: #0284c7 (Cyan 600)
+- **White**: #ffffff
+- **Dark Text**: #1e293b (Slate 800)
+- **Light Text**: #f1f5f9 (Slate 100)
+
+### Font Recommendations
+- **Title**: Inter Bold, Poppins Bold, or Montserrat Bold
+- **Body**: Inter Regular, Open Sans, or Roboto
+- **Code**: Fira Code, JetBrains Mono, or Consolas
+
+## Testing Your Image
+
+After creating, test it on:
+1. **Facebook Debugger**: https://developers.facebook.com/tools/debug/
+2. **Twitter Card Validator**: https://cards-dev.twitter.com/validator
+3. **LinkedIn Post Inspector**: https://www.linkedin.com/post-inspector/
+4. **OpenGraph.xyz**: https://www.opengraph.xyz/
+
+## Alternative: SVG to PNG Conversion
+
+If you want to use your existing `wrench.svg`:
+
+```bash
+# Using ImageMagick
+convert -background none -density 300 wrench.svg -resize 200x200 wrench.png
+
+# Or use an online tool
+# https://cloudconvert.com/svg-to-png
+```
+
+Then compose it with text using Canva or Figma.
+
+## Fallback
+
+If you don't create a custom image yet, update `index.html` to remove the og:image tag:
+
+```html
+<!-- Remove or comment out these lines temporarily -->
+<!-- <meta property="og:image" content="https://tools.lowlandtech.com/og-image.png" /> -->
+<!-- <meta property="twitter:image" content="https://tools.lowlandtech.com/og-image.png" /> -->
+```
+
+The page will still be shareable, just without a custom preview image.
+
+## Once Created
+
+1. Save as `site/public/og-image.png`
+2. Test the URL: `https://tools.lowlandtech.com/og-image.png`
+3. Run through validators above
+4. Share on social media to test!
+
+---
+
+**Pro Tip**: Create variations for different platforms:
+- `og-image.png` (1200x630 - Twitter/Facebook)
+- `og-image-square.png` (1200x1200 - Instagram)
+- `og-image-story.png` (1080x1920 - Stories)

site/SEO-CHECKLIST.md

@@ -0,0 +1,142 @@
+# SEO & Discoverability Checklist
+
+## ? Completed
+
+- [x] Enhanced meta tags in index.html (title, description, keywords)
+- [x] Open Graph tags for social sharing
+- [x] Twitter Card tags
+- [x] JSON-LD structured data (SoftwareApplication)
+- [x] Canonical URL specification
+- [x] robots.txt for crawler control (including AI bots)
+- [x] sitemap.xml with main pages
+- [x] AI reference guide (ai-reference.md)
+- [x] Crawler guide (crawl-guide.md)
+- [x] SEO optimization guide created
+
+## ?? High Priority (Do Next)
+
+### GitHub Repository
+- [ ] Add repository topics/tags on GitHub
+- [ ] Update repository description
+- [ ] Create social preview image (1200x630px)
+- [ ] Upload social preview to GitHub Settings
+- [ ] Enable GitHub Discussions
+- [ ] Add shields/badges to README
+
+### NuGet Package
+- [ ] Update .csproj with enhanced PackageTags
+- [ ] Add comprehensive Description
+- [ ] Include PackageReadmeFile
+- [ ] Add PackageIcon
+- [ ] Verify PackageProjectUrl points to docs site
+
+### Site & SEO Setup
+- [ ] Create og-image.png (1200x630) and upload to /public
+- [ ] Set up Google Search Console
+- [ ] Submit sitemap to Google Search Console
+- [ ] Set up analytics (Google Analytics or Plausible)
+- [ ] Verify HTTPS is working
+
+## ?? Medium Priority
+
+### Content Creation
+- [ ] Create /comparison page (FactoryTools vs Razor vs T4)
+- [ ] Create /use-cases page with examples
+- [ ] Create /faq page
+- [ ] Write first blog post about the project
+- [ ] Create migration guides (from Razor, from T4)
+
+### Community & Distribution
+- [ ] Submit to awesome-dotnet list
+- [ ] Submit to awesome-csharp list
+- [ ] Post on r/dotnet subreddit
+- [ ] Post on r/csharp subreddit
+- [ ] Share on dev.to
+- [ ] Share on LinkedIn
+- [ ] Tweet about launch
+
+### Documentation Improvements
+- [ ] Add breadcrumb navigation
+- [ ] Improve internal linking between pages
+- [ ] Add search functionality
+- [ ] Create "Popular Pages" section
+- [ ] Add "Edit on GitHub" links
+
+## ?? Low Priority (Ongoing)
+
+### Content Marketing
+- [ ] Create YouTube tutorial video
+- [ ] Write comparison blog post (vs Razor)
+- [ ] Write use-case blog posts
+- [ ] Answer Stack Overflow questions
+- [ ] Create Twitter content schedule
+- [ ] Guest post on .NET blogs
+
+### Advanced SEO
+- [ ] Add BreadcrumbList schema
+- [ ] Add FAQPage schema
+- [ ] Add HowTo schema for tutorials
+- [ ] Create sitemap page for users
+- [ ] Optimize images (WebP format)
+- [ ] Add alt text to all images
+
+### Community Building
+- [ ] Enable GitHub Sponsors
+- [ ] Create CONTRIBUTING.md
+- [ ] Create CODE_OF_CONDUCT.md
+- [ ] Label "good first issues"
+- [ ] Create issue templates
+- [ ] Set up PR templates
+
+### Alternative Platforms
+- [ ] List on AlternativeTo.net
+- [ ] List on SourceForge
+- [ ] List on Slant.co
+- [ ] Submit to .NET Foundation showcase
+- [ ] Submit to Microsoft Tech Community
+
+## ?? Metrics to Track
+
+### Weekly
+- [ ] NuGet download count
+- [ ] GitHub stars/forks
+- [ ] Documentation page views
+
+### Monthly
+- [ ] Google Search Console impressions/clicks
+- [ ] Keyword rankings
+- [ ] Backlinks acquired
+- [ ] Social media engagement
+- [ ] GitHub issues/PRs
+
+## ?? Goals
+
+### 1 Month
+- [ ] 100+ GitHub stars
+- [ ] 500+ NuGet downloads
+- [ ] Listed in 2+ awesome lists
+- [ ] 3+ blog posts published
+
+### 3 Months
+- [ ] 500+ GitHub stars
+- [ ] 2,000+ NuGet downloads
+- [ ] Top 10 for "lightweight .NET template engine"
+- [ ] 10+ backlinks from quality sites
+
+### 6 Months
+- [ ] 1,000+ GitHub stars
+- [ ] 10,000+ NuGet downloads
+- [ ] Featured on .NET blog or similar
+- [ ] Active community (issues, PRs, discussions)
+
+## ?? Notes
+
+- Update sitemap.xml when adding new pages
+- Test social sharing after each deploy
+- Monitor Google Search Console weekly
+- Engage with community feedback promptly
+- Keep README and docs in sync
+
+---
+
+Last updated: 2025-01-15